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

Статья
02/07/2025

Метод IStillImage::GetSTILaunchInformation возвращает причину запуска вызывающего приложения образа, если монитор событий по-прежнему запущен.

Синтаксис

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

Параметры

[out] pwszDeviceName

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

[out, optional] pdwEventCode

Зарезервировано для дальнейшего использования.

[out] pwszEventName

Вызывающий указатель на буфер, достаточно большой для получения строкового представления GUID. GUID представляет события устройства по-прежнему образов, для которых было запущено приложение.

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

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

Замечания

Если монитор событий по-прежнему запущен, pwszDeviceName и значения pwszEventName определяют значения /StiDevice и /StiEvent командной строки (см. описание IStillImage::RegisterLaunchApplication). Если монитор событий не запускал приложение, метод возвращает STIERR_GENERIC.

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	sti.h (include Sti.h)

Поделиться через