Compartir a través de

estructura WINHTTP_CERTIFICATE_INFO (winhttp.h)

  • Artículo

La estructura WINHTTP_CERTIFICATE_INFO contiene información de certificado devuelta desde el servidor. Esta estructura la usa la función WinHttpQueryOption .

Sintaxis

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;

Miembros

ftExpiry

Estructura FILETIME que contiene la fecha en que expira el certificado.

ftStart

Estructura FILETIME que contiene la fecha en que el certificado es válido.

lpszSubjectInfo

Puntero a un búfer que contiene el nombre de la organización, el sitio y el servidor para los que se emitió el certificado.

lpszIssuerInfo

Puntero a un búfer que contiene el nombre de la organización, el sitio y el servidor que emitió el certificado.

lpszProtocolName

Puntero a un búfer que contiene el nombre del protocolo utilizado para proporcionar la conexión segura. Este miembro no se usa actualmente.

lpszSignatureAlgName

Puntero a un búfer que contiene el nombre del algoritmo utilizado para firmar el certificado. Este miembro no se usa actualmente.

lpszEncryptionAlgName

Puntero a un búfer que contiene el nombre del algoritmo utilizado para realizar el cifrado a través de la conexión de canal seguro (SSL/TLS). Este miembro no se usa actualmente.

dwKeySize

Tamaño, en bytes, de la clave.

Comentarios

La estructura de WINHTTP_CERTIFICATE_INFO contiene información sobre el certificado devuelto por el servidor cuando la conexión usa SSL/TLS. La función WinHttpQueryOption devuelve la estructura WINHTTP_CERTIFICATE_INFO cuando el parámetro dwOption pasado a la función WinHttpQueryOption se establece en WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT. Para obtener más información, vea Marcas de opción.

La función WinHttpQueryOption no establece los miembros lpszProtocolName, lpszSignatureAlgName y lpszEncryptionAlgName de la estructura WINHTTP_CERTIFICATE_INFO , por lo que estos miembros siempre se devuelven como NULL.

Una vez que la aplicación ya no necesita la estructura de WINHTTP_CERTIFICATE_INFO devuelta, se debe llamar a la función LocalFree para liberar los punteros devueltos en la estructura. Los miembros de estructura que contienen punteros que no son NULL y deben liberarse son lpszSubjectInfo y lpszIssuerInfo.

Nota Para Windows XP y Windows 2000, consulta la sección Requisitos en tiempo de ejecución de la página de inicio servicios HTTP de Windows .
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Encabezado winhttp.h
Redistribuible WinHTTP 5.0 e Internet Explorer 5.01 o posterior en Windows XP y Windows 2000.

Consulte también

Marcas de opción

Versiones winHTTP

WinHttpQueryOption