HTTP_SSL_CLIENT_CERT_INFO 구조체(http.h)

HTTP_SSL_CLIENT_CERT_INFO 구조에는 인증서가 유효한지 여부를 확인하는 데 사용할 수 있는 SSL(Secure Sockets Layer) 클라이언트 인증서에 대한 데이터가 포함되어 있습니다.

구문

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 멤버로 가리키고, HttpReceiveClientCertificate 함수에서 pSslClientCertInfo 매개 변수를 통해 클라이언트 인증서에 대한 데이터를 반환하는 데 사용됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	http.h

추가 정보

HTTP 서버 API 버전 1.0 구조체

HTTP_SSL_INFO

HttpReceiveClientCertificate