IStillImageW::GetSTILaunchInformation 方法 (sti.h)

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.h中定义的 STIERR 前缀错误代码之一。

言论

如果静止图像事件监视器启动应用程序,pwszDeviceNamepwszEventName 值标识 /StiDevice/StiEvent 命令行参数(请参阅 IStillImage::RegisterLaunchApplication的说明)。 如果事件监视器未启动应用程序,该方法将返回STIERR_GENERIC。

在调用 IStillImage::GetSTILaunchInformation之前,IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。

要求

要求 价值
目标平台 桌面
标头 sti.h (include Sti.h)