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)