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 |