次の方法で共有

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 を含む)