Compartilhar via


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.

Nota Para Windows XP e Windows 2000, consulte a seção Requisitos de tempo de execução da página inicial dos Serviços HTTP do Windows .
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Cabeçalho winhttp.h
Redistribuível WinHTTP 5.0 e Internet Explorer 5.01 ou posterior no Windows XP e Windows 2000.

Confira também

Sinalizadores de opção

Versões do WinHTTP

WinHttpQueryOption