estrutura WINHTTP_CERTIFICATE_INFO (winhttp.h)

A estrutura WINHTTP_CERTIFICATE_INFO contém informações de certificado retornadas do servidor. Essa estrutura é usada pela função WinHttpQueryOption .

Sintaxe

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;

Membros

ftExpiry

Uma estrutura FILETIME que contém a data em que o certificado expira.

ftStart

Uma estrutura FILETIME que contém a data em que o certificado se torna válido.

lpszSubjectInfo

Um ponteiro para um buffer que contém o nome da organização, do site e do servidor para o qual o certificado foi emitido.

lpszIssuerInfo

Um ponteiro para um buffer que contém o nome da organização, do site e do servidor que emitiu o certificado.

lpszProtocolName

Um ponteiro para um buffer que contém o nome do protocolo usado para fornecer a conexão segura. Este membro não é usado atualmente.

lpszSignatureAlgName

Um ponteiro para um buffer que contém o nome do algoritmo usado para assinar o certificado. Este membro não é usado atualmente.

lpszEncryptionAlgName

Um ponteiro para um buffer que contém o nome do algoritmo usado para executar a criptografia na conexão de canal seguro (SSL/TLS). Este membro não é usado atualmente.

dwKeySize

O tamanho, em bytes, da chave.

Comentários

A estrutura WINHTTP_CERTIFICATE_INFO contém informações sobre o certificado retornado pelo servidor quando a conexão usa SSL/TLS. A função WinHttpQueryOption retorna a estrutura WINHTTP_CERTIFICATE_INFO quando o parâmetro dwOption passado para a função WinHttpQueryOption é definido como WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT. Para obter mais informações, consulte Sinalizadores de opção.

A função WinHttpQueryOption não define os membros lpszProtocolName, lpszSignatureAlgName e lpszEncryptionAlgName da estrutura WINHTTP_CERTIFICATE_INFO , portanto, esses membros sempre são retornados como NULL.

Depois que o aplicativo não precisar mais da estrutura de WINHTTP_CERTIFICATE_INFO retornada, a função LocalFree deverá ser chamada para liberar quaisquer ponteiros retornados na estrutura. Os membros da estrutura que contêm ponteiros que não são NULL e precisam ser liberados são lpszSubjectInfo e lpszIssuerInfo.

Requisitos

Confira também

Sinalizadores de opção

Versões do WinHTTP

WinHttpQueryOption