estrutura HTTP_SSL_CLIENT_CERT_INFO (http.h)

A estrutura HTTP_SSL_CLIENT_CERT_INFO contém dados sobre um certificado de cliente SSL (Secure Sockets Layer) que podem ser usados para determinar se o certificado é válido.

Sintaxe

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;

Membros

CertFlags

Sinalizadores que indicam se o certificado é válido. Os valores possíveis para esse membro são um código de status SSPI retornado do SSPI ou um dos seguintes sinalizadores do membro dwError da estrutura CERT_CHAIN_POLICY_STATUS :

CERT_E_EXPIRED

CERT_E_UNTRUSTEDCA

CERT_E_WRONG_USAGE

CERT_E_UNTRUSTEDROOT

CERT_E_REVOKED

CERT_E_CN_NO_MATCH

CertEncodedSize

O tamanho, em bytes, do certificado.

pCertEncoded

Um ponteiro para o certificado real.

Token

Um identificador para um token de acesso. Se o sinalizador HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER for definido usando a função HttpSetServiceConfiguration e o certificado do cliente tiver sido mapeado com êxito para uma conta de usuário do sistema operacional, esse membro conterá o identificador para um token de acesso válido. Quando a estrutura HTTP_SSL_CLIENT_CERT_INFO não for mais necessária, libere esse token explicitamente fechando o identificador.

CertDeniedByMapper

Reservado.

Comentários

Uma estrutura HTTP_SSL_CLIENT_CERT_INFO é apontada pelo membro pClientCertInfo da estrutura HTTP_SSL_INFO e é usada pela função HttpReceiveClientCertificate para retornar dados sobre o certificado do cliente por meio do parâmetro pSslClientCertInfo .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	http.h

Confira também

Estruturas da API do Servidor HTTP versão 1.0

HTTP_SSL_INFO

HttpReceiveClientCertificate