HTTP_SSL_CLIENT_CERT_INFO 構造体 (http.h)
HTTP_SSL_CLIENT_CERT_INFO構造には、証明書が有効かどうかを判断するために使用できる Secure Sockets Layer (SSL) クライアント証明書に関するデータが含まれています。
構文
typedef struct _HTTP_SSL_CLIENT_CERT_INFO {
ULONG CertFlags;
ULONG CertEncodedSize;
PUCHAR pCertEncoded;
HANDLE Token;
BOOLEAN CertDeniedByMapper;
} HTTP_SSL_CLIENT_CERT_INFO, *PHTTP_SSL_CLIENT_CERT_INFO;
メンバー
CertFlags
証明書が有効かどうかを示すフラグ。 このメンバーに指定できる値は、SSPI から返される SSPI 状態コード、またはCERT_CHAIN_POLICY_STATUS構造体の dwError メンバーから次のいずれかのフラグです。
CERT_E_EXPIRED
CERT_E_UNTRUSTEDCA
CERT_E_WRONG_USAGE
CERT_E_UNTRUSTEDROOT
CERT_E_REVOKED
CERT_E_CN_NO_MATCH
CertEncodedSize
証明書のサイズ (バイト単位)。
pCertEncoded
実際の証明書へのポインター。
Token
アクセス トークンのハンドル。 httpSetServiceConfiguration 関数を使用してHTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER フラグが設定され、クライアント証明書がオペレーティング システム ユーザー アカウントに正常にマップされた場合、このメンバーには有効なアクセス トークンへのハンドルが含まれます。 HTTP_SSL_CLIENT_CERT_INFO構造体が不要になったら、ハンドルを閉じてこのトークンを明示的に解放します。
CertDeniedByMapper
予約済み。
注釈
HTTP_SSL_CLIENT_CERT_INFO構造体は、HTTP_SSL_INFO構造体の pClientCertInfo メンバーによって指され、pSslClientCertInfo パラメーターを使用してクライアント証明書に関するデータを返すために HttpReceiveClientCertificate 関数によって使用されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| Header | http.h |