ホーム › Networking.WindowsWebServices › WS_VALIDATE_SAML_CALLBACK

WS_VALIDATE_SAML_CALLBACK

コールバック

シグネチャ

HRESULT WS_VALIDATE_SAML_CALLBACK(
    void* samlValidatorCallbackState,
    WS_XML_BUFFER* samlAssertion,
    WS_ERROR* error
);

パラメーター

フィールド	型	説明
samlValidatorCallbackState	void*	このコールバックを呼び出すときに渡される状態です。
samlAssertion	WS_XML_BUFFER*	署名チェックに成功した、受信済みの SAML アサーションです。
error	WS_ERROR*	関数が失敗した場合に、追加のエラー情報を格納する場所を指定します。

公式ドキュメント

SAML アサーションを検証します。受信した SAML アサーションが、信頼された発行者によって発行されたことを保証する署名検証のチェックに合格すると、このコールバックが呼び出され、アプリケーションは SAML アサーションの XML 形式に対して追加の検証を行うことができます。このコールバックは、SAML アサーションの検証に成功した場合は S_OK を、アサーションを検証できなかった場合は S_FALSE を、予期しないエラーが発生した場合はエラー値を返すことが求められます。このコールバックから S_OK 以外の結果を返すと、関連する受信メッセージはセキュリティエラーで失敗します。

すべてのセキュリティコールバックと同様に、アプリケーションはリスナーのオープンからクローズまでの間、いつでもこのコールバックを受け取る可能性がありますが、リスナーがオープンしていないときに呼び出されることはありません。

戻り値

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

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