IStillImageW::RegisterLaunchApplication メソッド (sti.h)

IStillImage::RegisterLaunchApplication メソッドは、静止画像イベント モニターのプッシュ モデル対応アプリケーションの一覧にアプリケーションを追加します。

構文

HRESULT RegisterLaunchApplication(
  [in] LPWSTR pwszAppName,
  [in] LPWSTR pwszCommandLine
);

パラメーター

[in] pwszAppName

アプリケーションの "短い名前" を表す文字列への呼び出し元指定のポインター。スキャナーとカメラコントロール パネルのプロパティ シートが表示されます。

[in] pwszCommandLine

アプリケーションの実行可能ファイルへの完全パスを含め、アプリケーションの起動に必要なコマンド ラインを表す文字列への呼び出し元指定のポインター。 現在のパスは、GetModuleFileName を呼び出すことによって取得できます (Microsoft Windows SDKドキュメントで説明されています)。 詳細については、次の 「解説 」セクションを参照してください。

戻り値

操作が成功した場合、メソッドは S_OKを返します。 それ以外の場合は、 stierr.h で定義されている STIERR プレフィックス付きエラー コードのいずれかを返します。

注釈

アプリケーション (またはアプリケーションのインストーラー) は IStillImage::RegisterLaunchApplication を呼び出して、静止画像イベント モニターがその存在を認識できるようにする必要があります。 ユーザーは、コントロール パネルのプロパティ シート インターフェイスを使用して、静止画像デバイス イベントを登録済みアプリケーションに関連付けます。 ユーザーがデバイス イベントをアプリケーションに関連付けた後、イベント が発生すると、イベント モニターによってアプリケーションが起動されます。

メソッドは、アプリケーションの読み込みパスをレジストリに書き込みます。 したがって、ユーザーがファイルを移動し、 GetModuleFileName が常に現在のファイルの場所を返す可能性があるため、アプリケーションを実行するたびに メソッドを呼び出す必要があります。

アプリケーションのコマンド ラインにコマンド引数を含めることができます。 登録済みアプリケーションを起動すると、イベント モニターによってコマンド ラインに次の 2 つの引数が追加されます。

コマンド ライン引数	説明
**/StiDevice:**InternalDeviceName	InternalDeviceName は、アプリケーションが起動されているデバイスの内部デバイス名です。
**/StiEvent:**EventGUID	EventGUID は、発生したデバイス イベントの GUID の文字列表現です。

アプリケーションは、 IStillImage::GetSTILaunchInformation を呼び出すことによって、これらの引数に指定された値を取得できます。

IStillImage::RegisterLaunchApplication を呼び出す前に、IStillImage COM インターフェイスのクライアントが IStillImage::StiCreateInstance を呼び出して IStillImage インターフェイス ポインターを取得する必要があります。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	sti.h (Sti.h を含む)