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

接続を承認します。 プラグインは、このユーザーが操作を実行することを許可されていることを確認する必要があります。 ユーザーが操作を実行できる場合、プラグインは成功を報告する必要があります。 ユーザーが任意の種類の操作を実行できない場合は、エラーを返す必要があります。

すべての新しい接続を承認する必要はありません。 ユーザーが接続を承認されると、ユーザーのアクティビティを追跡するためのユーザー レコードが作成されます。 そのレコードが存在する間は、すべての新しい接続が自動的に承認されます。 アクティビティが検出されないと、構成可能な時間が経過すると、ユーザー レコードはタイムアウトします。

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

構文

WSMAN_PLUGIN_AUTHORIZE_USER WsmanPluginAuthorizeUser;

void WsmanPluginAuthorizeUser(
  [in] PVOID pluginContext,
  [in] WSMAN_SENDER_DETAILS *senderDetails,
  [in] DWORD flags
)
{...}

パラメーター

[in] pluginContext

WSManPluginStartup の呼び出しによって返されたコンテキストを指定します。 このパラメーターは、WinRM プラグインの特定のアプリケーション初期化を表します。

[in] senderDetails

承認されるユーザーの識別情報を指定する WSMAN_SENDER_DETAILS 構造体へのポインター。

[in] flags

将来利用するために予約されています。 0 に設定する必要があります。

戻り値

なし

解説

プラグインは WSManPluginAuthzUserComplete を呼び出して、ユーザーが NO_ERROR で正常に承認されたか、ユーザーが ERROR_ACCESS_DENIED で承認されていないことを報告する必要があります。 このユーザーに HTTP リダイレクトが必要であり、新しい HTTP URI を WSManPluginAuthzUserComplete メソッドの extendedErrorInformation に記録する必要がある場合は、ERROR_WSMAN_REDIRECT_REQUIRED エラーを報告する必要があります。 その他のエラーはすべてクライアントにエラーを報告しますが、特定の情報は報告されません。

要件

サポートされている最小のクライアント	Windows 7
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	wsman.h
再頒布可能パッケージ	Windows Server 2008 SP2、Windows Vista sp1、Windows Vista sp2 でのWindows Management Framework