estructura de HTTP_SSL_CLIENT_CERT_INFO (http.h)

La estructura de HTTP_SSL_CLIENT_CERT_INFO contiene datos sobre un certificado de cliente de Capa de sockets seguros (SSL) que se puede usar para determinar si el certificado es válido.

Sintaxis

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;

Miembros

CertFlags

Marcas que indican si el certificado es válido. Los valores posibles para este miembro son un código de estado SSPI devuelto desde SSPI o una de las marcas siguientes del miembro dwError de la estructura 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

Tamaño, en bytes, del certificado.

pCertEncoded

Puntero al certificado real.

Token

Identificador de un token de acceso. Si la marca de HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER se establece mediante la función HttpSetServiceConfiguration y el certificado de cliente se asignó correctamente a una cuenta de usuario del sistema operativo, este miembro contiene el identificador de un token de acceso válido. Cuando la estructura de HTTP_SSL_CLIENT_CERT_INFO ya no sea necesaria, libere este token explícitamente cerrando el identificador.

CertDeniedByMapper

Reservado.

Comentarios

La función HttpReceiveClientCertificate señala una estructura HTTP_SSL_CLIENT_CERT_INFO al miembro pClientCertInfo de la estructura HTTP_SSL_INFO y la función HttpReceiveClientCertificate usa para devolver datos sobre el certificado de cliente a través del parámetro pSslClientCertInfo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	http.h

Consulte también

Estructuras de la API de servidor HTTP versión 1.0

HTTP_SSL_INFO

HttpReceiveClientCertificate