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 为前缀的错误代码之一。

注解

如果静态图像事件监视器启动了应用程序， 则 pwszDeviceName 和 pwszEventName 值标识 /StiDevice 和 /StiEvent 命令行参数 (请参阅 IStillImage：：RegisterLaunchApplication) 的说明。 如果事件监视器未启动应用程序，该方法将返回STIERR_GENERIC。

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

要求

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