HttpReceiveClientCertificate

HttpReceiveClientCertificate 関数はサーバーアプリケーションがクライアント SSL 証明書またはチャネルバインディングトークン (CBT) を取得するために使用する。

HttpReceiveClientCertificate RequestQueueHandle, ConnectionId, Flags, SslClientCertInfo, SslClientCertInfoSize, BytesReceived, Overlapped

RequestQueueHandle : [intptr] 指定 SSL クライアントまたは CBT が関連付けられたリクエストキューへのハンドル。リクエストキューは HttpCreateRequestQueue で作成される。Windows Server 2003 SP1 および Windows XP SP2 ではハンドルは HttpCreateHttpHandle により作成される。
ConnectionId : [int64] クライアントへの接続を識別する値。HttpReceiveHttpRequest で取得した HTTP_REQUEST の ConnectionId メンバから得る。
Flags : [int] HttpReceiveClientCertificate の動作を変更する値。このドキュメントは省略されている。
SslClientCertInfo : [var] Flags が 0 の場合、このパラメータは HTTP_SSL_CLIENT_CERT_INFO 構造体を指し、関数はここに要求クライアント証明書情報を書き込む。バッファは HTTP_SSL_CLIENT_CERT_INFO 構造体とその CertEncodedSize メンバの値を合わせたサイズ以上が必要である。Flags が HTTP_RECEIVE_SECURE_CHANNEL_TOKEN の場合は HTTP_REQUEST_CHANNEL_BIND_STATUS 構造体を指し、そこに CBT 情報が書き込まれる。
SslClientCertInfoSize : [int] pSslClientCertInfo が指すバッファのサイズ (バイト単位)。
BytesReceived : [var] pSslClientCertInfo が指す構造体に書き込まれるバイト数を受け取る任意の変数へのポインタ。使用しない場合は NULL にする。pOverlapped で非同期呼び出しをする場合は NULL にし、それ以外 (pOverlapped が NULL) は有効なアドレスが必要である。
Overlapped : [var] 非同期呼び出しの場合は pOverlapped に OVERLAPPED 構造体へのポインタを設定する。同期呼び出しの場合は NULL にする。

(プラグイン / モジュール : httpapi.dll)

解説

HttpReceiveClientCertificate 関数はサーバーアプリケーションがクライアント SSL
証明書またはチャネルバインディングトークン (CBT) を取得するために使用する。

[戻り値]
このドキュメントは省略されている。

[備考]
HttpReceiveClientCertificate の動作はクライアント SSL
証明書を要求するかチャネルバインディングトークンを要求するかで変わる。同期呼び出しの場合、受信バイト数は pBytesReceived
が指す値で返される。非同期呼び出しの場合、受信バイト数は標準的な非同期機構で返される (GetOverlappedResult が返す
lpNumberOfBytesTransferred)。

情報