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 |