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

こちらもご覧ください

HTTP Server API バージョン 1.0 構造体

HTTP_SSL_INFO

HttpReceiveClientCertificate