ホーム › System.RemoteManagement › WSMAN_PLUGIN_STARTUP

WSMAN_PLUGIN_STARTUP

コールバック

シグネチャ

DWORD WSMAN_PLUGIN_STARTUP(
    DWORD flags,
    LPWSTR applicationIdentification,
    LPWSTR extraInfo,
    void** pluginContext
);

パラメーター

フィールド	型	説明
flags	DWORD	将来の使用のために予約されています。0 でなければなりません。
applicationIdentification	LPWSTR	ホストされるアプリケーションの一意の識別子です。メインの WinRM サービスの場合、既定値は wsman です。インターネットインフォメーションサービス (IIS) ホストの場合、この識別子はそのホストのアプリケーションエンドポイントに関連します。たとえば wsman/MyCompany/MyApplication のようになります。
extraInfo	LPWSTR	プラグインの登録時に構成情報が保存されていた場合、その情報を含む文字列です。WinRM の構成を使用してプラグインを登録する際、プラグインは初期化時に役立つ追加の構成パラメーターを省略可能なノードに追加できます。この情報は、プラグインが異なる IIS ホスティングシナリオで使用され、初期化時にわずかに異なる実行時セマンティクスを必要とする場合に特に有用です。この文字列は、構成に XML が存在する場合はそのコピーです。存在しない場合、このパラメーターには NULL が設定されます。
pluginContext	void**	特定のアプリケーション初期化に対するコンテキストです。このコンテキストは、この applicationIdentifier に関連付けられた他のすべての WinRM プラグイン呼び出しに引き渡されます。

公式ドキュメント

プラグインのスタートアップコールバックを定義します。同じプロセス内で複数のアプリケーションをホストできるため、このメソッドは複数回呼び出されることがありますが、各アプリケーションの初期化につき 1 回だけ呼び出されます。プラグインは同一プロセス内で複数回初期化できますが、applicationIdentification の値ごとには 1 回だけです。このメソッドから返されるコンテキストは、アプリケーション固有のものにする必要があります。返されたコンテキストは、そのアプリケーションに固有の以降のすべてのプラグイン呼び出しに渡されます。すべての Windows リモート管理 (WinRM) プラグインは、このコールバック関数を実装する必要があります。

このメソッドの DLL エントリポイント名は WSManPluginStartup でなければなりません。

戻り値

成功した場合、このメソッドは NO_ERROR を返します。それ以外の場合はエラーコードを返します。このメソッドがエラーを返した場合、WSManPluginShutdown エントリポイントは呼び出されません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)