ホーム › Networking.WindowsWebServices › WS_CERTIFICATE_VALIDATION_CALLBACK

WS_CERTIFICATE_VALIDATION_CALLBACK

コールバック

シグネチャ

HRESULT WS_CERTIFICATE_VALIDATION_CALLBACK(
    CERT_CONTEXT* certContext,
    void* state
);

パラメーター

フィールド	型	説明
certContext	CERT_CONTEXT*	接続に関連付けられている CERT_CONTEXT 構造体へのポインター。アプリケーションは、CertFreeCertificateContext を使用してこの構造体を解放する必要があります。
state	void*	アプリケーション固有の状態情報へのポインター。このパラメーターは、WS_CERTIFICATE_VALIDATION_CALLBACK_CONTEXT 構造体の state メンバーに対応します。

公式ドキュメント

WS_CERTIFICATE_VALIDATION_CALLBACK コールバックは、HTTP サーバーへの接続が確立されてヘッダーが送信されたときに、証明書を検証するために呼び出されます。

戻り値

このコールバック関数は、次のいずれかの値を返すことができます。

戻り値	説明
S_OK	証明書の検証に成功しました。
その他のエラー	この関数は、上記以外のエラーを返す場合があります。

解説(Remarks)

WS_CERTIFICATE_VALIDATION_CALLBACK が S_OK 以外の値を返した場合、チャネルは中止されます。このプロパティが WsCreateServiceProxy に渡されていた場合は、サービスプロキシも中止されます。

コールバックの実装では、呼び出し元にすばやく制御を返せるように、長時間の計算処理や長時間ブロックする呼び出しを避ける必要があります。

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