structure WINHTTP_CERTIFICATE_INFO (winhttp.h)

Article
08/27/2023

La structure WINHTTP_CERTIFICATE_INFO contient des informations de certificat retournées par le serveur. Cette structure est utilisée par la fonction WinHttpQueryOption .

Syntaxe

typedef struct _WINHTTP_CERTIFICATE_INFO {
  FILETIME ftExpiry;
  FILETIME ftStart;
  LPWSTR   lpszSubjectInfo;
  LPWSTR   lpszIssuerInfo;
  LPWSTR   lpszProtocolName;
  LPWSTR   lpszSignatureAlgName;
  LPWSTR   lpszEncryptionAlgName;
  DWORD    dwKeySize;
} WINHTTP_CERTIFICATE_INFO, *PWINHTTP_CERTIFICATE_INFO;

Membres

ftExpiry

Structure FILETIME qui contient la date d’expiration du certificat.

ftStart

Structure FILETIME qui contient la date à laquelle le certificat devient valide.

lpszSubjectInfo

Pointeur vers une mémoire tampon qui contient le nom du organization, du site et du serveur pour lequel le certificat a été émis.

lpszIssuerInfo

Pointeur vers une mémoire tampon qui contient le nom du organization, du site et du serveur qui a émis le certificat.

lpszProtocolName

Pointeur vers une mémoire tampon qui contient le nom du protocole utilisé pour fournir la connexion sécurisée. Ce membre n’est pas utilisé actuellement.

lpszSignatureAlgName

Pointeur vers une mémoire tampon qui contient le nom de l’algorithme utilisé pour signer le certificat. Ce membre n’est pas utilisé actuellement.

lpszEncryptionAlgName

Pointeur vers une mémoire tampon qui contient le nom de l’algorithme utilisé pour effectuer le chiffrement sur la connexion de canal sécurisé (SSL/TLS). Ce membre n’est pas utilisé actuellement.

dwKeySize

Taille, en octets, de la clé.

Remarques

La structure WINHTTP_CERTIFICATE_INFO contient des informations sur le certificat retourné par le serveur lorsque la connexion utilise SSL/TLS. La fonction WinHttpQueryOption retourne la structure WINHTTP_CERTIFICATE_INFO lorsque le paramètre dwOption passé à la fonction WinHttpQueryOption est défini sur WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT. Pour plus d’informations, consultez Indicateurs d’option.

La fonction WinHttpQueryOption ne définit pas les membres lpszProtocolName, lpszSignatureAlgName et lpszEncryptionAlgName de la structure WINHTTP_CERTIFICATE_INFO , de sorte que ces membres sont toujours retournés avec la valeur NULL.

Une fois que l’application n’a plus besoin de la structure WINHTTP_CERTIFICATE_INFO retournée, la fonction LocalFree doit être appelée pour libérer tous les pointeurs retournés dans la structure. Les membres de structure contenant des pointeurs qui ne sont pas NULL et qui doivent être libérés sont lpszSubjectInfo et lpszIssuerInfo.

Note Pour Windows XP et Windows 2000, consultez la section Conditions requises pour l’exécution de la page de démarrage des services HTTP Windows .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
En-tête	winhttp.h
Composant redistribuable	WinHTTP 5.0 et Internet Explorer 5.01 ou version ultérieure sur Windows XP et Windows 2000.

Voir aussi

Indicateurs d’option

WinHTTP Versions

WinHttpQueryOption

Partager via