ホーム › System.RemoteManagement › WSMAN_PLUGIN_AUTHORIZE_USER

WSMAN_PLUGIN_AUTHORIZE_USER

コールバック

シグネチャ

void WSMAN_PLUGIN_AUTHORIZE_USER(
    void* pluginContext,
    WSMAN_SENDER_DETAILS* senderDetails,
    DWORD flags
);

パラメーター

フィールド	型	説明
pluginContext	void*	WSManPluginStartup の呼び出しによって返されたコンテキストを指定します。このパラメーターは、WinRM プラグインの特定のアプリケーション初期化を表します。
senderDetails	WSMAN_SENDER_DETAILS*	承認対象のユーザーの識別情報を指定する WSMAN_SENDER_DETAILS 構造体へのポインターです。
flags	DWORD	将来の使用のために予約されています。0 に設定する必要があります。

公式ドキュメント

接続を承認します。プラグインは、このユーザーが操作を実行することを許可されているかどうかを検証する必要があります。ユーザーが操作の実行を許可されている場合、プラグインは成功を報告しなければなりません。ユーザーがいかなる種類の操作も実行できない場合は、失敗を返す必要があります。

すべての新しい接続を承認する必要があるわけではありません。ユーザーが接続を承認されると、そのユーザーの活動を追跡するためのユーザーレコードが作成されます。そのレコードが存在する間、新しい接続はすべて自動的に承認されます。ユーザーレコードは、活動が検出されない状態が設定可能な時間だけ続いた後にタイムアウトします。

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

解説(Remarks)

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

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