Win32 API 日本語リファレンス
ホーム › Networking.WindowsWebServices › WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK

WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK

コールバック

シグネチャ

HRESULT WS_CERT_ISSUER_LIST_NOTIFICATION_CALLBACK(
    void* certIssuerListNotificationCallbackState,
    SecPkgContext_IssuerListInfoEx* issuerList,
    WS_ERROR* error
);

パラメーター

フィールド型説明
certIssuerListNotificationCallbackStatevoid*WS_CUSTOM_CERT_CREDENTIAL でこのコールバックとともに指定された状態です。
issuerListSecPkgContext_IssuerListInfoEx*サーバーが受け入れ可能な証明書発行者の一覧です。
errorWS_ERROR*関数が失敗した場合に、追加のエラー情報を格納する場所を指定します。

公式ドキュメント

サーバーが受け入れ可能な証明書発行者の一覧を クライアントに通知します。SSL などの一部のプロトコルでは、 クライアントが証明書を選択しやすいように、サーバーが任意で このような発行者一覧を送信することがあります。

このコールバックは WS_CUSTOM_CERT_CREDENTIAL の省略可能な要素です。 WS_GET_CERT_CALLBACK が返した証明書 (NULL の場合もあります) が サーバーに受け入れられた場合、このコールバックが呼び出されることはありません。 サーバーがその証明書を拒否して発行者一覧を返した場合に、 このコールバックが呼び出されます。クライアントは、その発行者一覧に基づいて 証明書を選択し、次にチャネルが開かれて WS_GET_CERT_CALLBACK が 再度呼び出されたときに、その証明書を指定できます。

このコールバックで渡されるパラメーターは、コールバックの実行中のみ有効です。

戻り値

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

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