HTTP_SSL_CLIENT_CERT_INFO structure (http.h)

Article
03/06/2024

La structure HTTP_SSL_CLIENT_CERT_INFO contient des données relatives à un certificat client SSL (Secure Sockets Layer) qui peut être utilisé pour déterminer si le certificat est valide.

Syntaxe

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;

Membres

CertFlags

Indicateurs qui indiquent si le certificat est valide. Les valeurs possibles pour ce membre sont un code d’état SSPI retourné par SSPI ou l’un des indicateurs suivants du membre dwError de la structure 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

Taille, en octets, du certificat.

pCertEncoded

Pointeur vers le certificat réel.

Token

Handle pour un jeton d’accès. Si l’indicateur HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER est défini à l’aide de la fonction HttpSetServiceConfiguration et que le certificat client a été correctement mappé à un compte d’utilisateur du système d’exploitation, ce membre contient le handle à un jeton d’accès valide. Lorsque la structure HTTP_SSL_CLIENT_CERT_INFO n’est plus nécessaire, libérez ce jeton explicitement en fermant le handle.

CertDeniedByMapper

Réservé.

Remarques

Une structure HTTP_SSL_CLIENT_CERT_INFO est pointée par le membre pClientCertInfo de la structure HTTP_SSL_INFO et est utilisée par la fonction HttpReceiveClientCertificate pour retourner des données sur le certificat client via le paramètre pSslClientCertInfo .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	http.h

Voir aussi

Structures de l’API serveur HTTP version 1.0

HTTP_SSL_INFO

HttpReceiveClientCertificate

Partager via