ホーム › Networking.WindowsWebServices › WS_GET_CERT_CALLBACK

WS_GET_CERT_CALLBACK

コールバック

シグネチャ

HRESULT WS_GET_CERT_CALLBACK(
    void* getCertCallbackState,
    WS_ENDPOINT_ADDRESS* targetAddress,
    WS_STRING* viaUri,
    CERT_CONTEXT** cert,
    WS_ERROR* error
);

パラメーター

フィールド	型	説明
getCertCallbackState	void*	証明書の資格情報において、このコールバックとともに指定された状態です。
targetAddress	WS_ENDPOINT_ADDRESS*	この証明書の資格情報がクライアント用に指定されている場合に、この証明書の提示先となるターゲットアドレスです。
viaUri	WS_STRING*	この証明書の提示先となる via アドレスです。 - **cert 証明書を返す場所です。
cert	CERT_CONTEXT**	証明書を返す場所です。
error	WS_ERROR*	関数が失敗した場合に、追加のエラー情報を格納する場所を指定します。

公式ドキュメント

セキュリティランタイムに証明書を提供します。このコールバックは WS_CUSTOM_CERT_CREDENTIAL の一部として指定され、それ自体は証明書の資格情報を必要とするセキュリティバインディングの一部として指定できます。ランタイムは、チャネル (クライアント側) またはリスナー (サーバー側) が開かれたときに、このコールバックを呼び出します。

証明書の所有権: このコールバックが成功を示す HRESULT を返した場合、呼び出し元 (すなわちセキュリティランタイム) は返された証明書の所有権を取得し、その証明書を保持するチャネルが不要になった時点で解放します。このコールバックが失敗を示す HRESULT を返した場合、呼び出し元は出力パラメーター 'cert' に返された値の所有権を取得せず、その値を参照することもありません。

戻り値

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

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

WS_GET_CERT_CALLBACK

シグネチャ

パラメーター

- **cert

公式ドキュメント

戻り値