ホーム › Networking.WindowsWebServices › WS_VALIDATE_PASSWORD_CALLBACK

WS_VALIDATE_PASSWORD_CALLBACK

コールバック

シグネチャ

HRESULT WS_VALIDATE_PASSWORD_CALLBACK(
    void* passwordValidatorCallbackState,
    WS_STRING* username,
    WS_STRING* password,
    WS_ASYNC_CONTEXT* asyncContext,
    WS_ERROR* error
);

パラメーター

フィールド	型	説明
passwordValidatorCallbackState	void*	このコールバックを呼び出すときに渡される状態。
username	WS_STRING*	受信したユーザー名。
password	WS_STRING*	受信したパスワード。
asyncContext	WS_ASYNC_CONTEXT*	関数を非同期的に呼び出す方法に関する情報。同期的に呼び出す場合は NULL。
error	WS_ERROR*	関数が失敗した場合に追加のエラー情報を格納する場所を指定します。

公式ドキュメント

受信側でユーザー名とパスワードのペアを検証します。このコールバックを含む WS_USERNAME_MESSAGE_SECURITY_BINDING がセキュリティ記述に含まれている場合、このコールバックはサーバーで受信したメッセージごとに呼び出されます。このコールバックは、ユーザー名とパスワードのペアの検証に成功した場合は S_OK、ペアを検証できなかった場合は S_FALSE、予期しないエラーが発生した場合はエラー値を返すことが期待されます。このコールバックから S_OK 以外の結果を返した場合、対応する受信メッセージはセキュリティエラーで失敗します。

すべてのセキュリティコールバックと同様に、アプリケーションは、チャネル/リスナーのオープンからクローズまでの間はいつでもこのコールバックを受け取る可能性があることを想定する必要がありますが、チャネルがオープンしていないときに呼び出されることはありません。
現在のドロップでは、このコールバックは常に同期的に呼び出されます。次のドロップでは、同期的なメッセージ受信では同期的に、非同期的なメッセージ受信では非同期的に呼び出されますが、非同期的に呼び出される場合は常に short で呼び出されます。

戻り値

このコールバック関数は値を返しません。

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