Метод IStillImageW::RegisterLaunchApplication (sti.h)

Метод IStillImage::RegisterLaunchApplication добавляет приложение в список приложений с поддержкой push-моделей монитора событий по-прежнему.

Синтаксис

HRESULT RegisterLaunchApplication(
  [in] LPWSTR pwszAppName,
  [in] LPWSTR pwszCommandLine
);

Параметры

[in] pwszAppName

Вызывающий указатель на строку, представляющую "короткое имя", которое отображается на листе свойств панели управления сканеров и камер.

[in] pwszCommandLine

Вызывающий указатель на строку, представляющую командную строку, необходимую для запуска приложения, включая полный путь к исполняемому файлу приложения. Текущий путь можно получить путем вызова GetModuleFileName (описано в документации по пакету SDK для Microsoft Windows). Дополнительные сведения см. в следующем разделе Примечания.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Приложение (или установщик приложения) должно вызывать IStillImage::RegisterLaunchApplication чтобы монитор событий образов знал о его существовании. Пользователи связывают события устройства по-прежнему с зарегистрированными приложениями с помощью интерфейса листа свойств панели управления. После того как пользователь связыл событие устройства с приложением, монитор событий запустит приложение при возникновении события.

Метод записывает путь загрузки приложения в реестр. Поэтому метод должен вызываться при каждом запуске приложения, так как пользователь может переместить файл и GetModuleFileName всегда возвращает текущее расположение файла.

В командную строку приложения можно включить аргументы команд. При запуске зарегистрированного приложения монитор событий добавляет следующие два аргумента в командную строку:

Приложение может получить значения, указанные для этих аргументов, вызвав IStillImage::GetSTILaunchInformation.

Перед вызовом IStillImage::RegisterLaunchApplicationклиенты интерфейса IStillImage IStillImage должны вызывать IStillImage::StiCreateInstance для получения указателя интерфейса IStillImage.

Требования