WSMAN_PLUGIN_STARTUP コールバック関数 (wsman.h)

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

このメソッドの DLL エントリ ポイント名は WSManPluginStartup である必要があります。

構文

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

DWORD WsmanPluginStartup(
  DWORD flags,
  PCWSTR applicationIdentification,
  PCWSTR extraInfo,
  PVOID *pluginContext
)
{...}

パラメーター

flags

将来利用するために予約されています。 ゼロを指定してください。

applicationIdentification

ホストされているアプリケーションの一意識別子。 メイン WinRM サービスの場合、既定値は wsman です。 インターネット インフォメーション サービス (IIS) ホストの場合、この識別子は、そのホストのアプリケーション エンドポイントに関連しています。 たとえば、 wsman/MyCompany/MyApplication です。

extraInfo

プラグインの登録時に情報が格納された場合は、構成情報を含む文字列。 プラグインが WinRM 構成を使用して登録されている場合、プラグインは、初期化中に役立つ追加の構成パラメーターを省略可能なノードに追加できます。 この情報は、プラグインが異なる IIS ホスティング シナリオで使用され、初期化中に若干異なる実行時セマンティクスを必要とする場合に特に役立ちます。 この文字列は、構成からの XML のコピーです (存在する場合)。 それ以外の場合、このパラメーターは NULL に設定されます。

pluginContext

特定のアプリケーション初期化のコンテキスト。 このコンテキストは、この applicationIdentifier に関連付けられている他のすべての WinRM プラグイン呼び出しに渡されます。

戻り値

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

要件