Função ImageGetCertificateData (imagehlp.h)

Recupera um certificado completo de um arquivo.

Sintaxe

BOOL IMAGEAPI ImageGetCertificateData(
  [in]      HANDLE            FileHandle,
  [in]      DWORD             CertificateIndex,
  [out]     LPWIN_CERTIFICATE Certificate,
  [in, out] PDWORD            RequiredLength
);

Parâmetros

[in] FileHandle

Um identificador para o arquivo de imagem. Esse identificador deve ser aberto para acesso FILE_READ_DATA .

[in] CertificateIndex

O índice do certificado a ser retornado.

[out] Certificate

Um ponteiro para uma estrutura WIN_CERTIFICATE que recebe os dados do certificado. Se o buffer não for grande o suficiente para conter a estrutura, a função falhará e o último código de erro será definido como ERROR_INSUFFICIENT_BUFFER.

[in, out] RequiredLength

Na entrada, esse parâmetro especifica o comprimento do buffer de certificado em bytes. Em caso de êxito, ele recebe a duração do certificado.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A estrutura WIN_CERTIFICATE é definida da seguinte maneira:

typedef struct _WIN_CERTIFICATE {
    DWORD       dwLength;
    WORD        wRevision;
    WORD        wCertificateType;   // WIN_CERT_TYPE_xxx
    BYTE        bCertificate[ANYSIZE_ARRAY];
} WIN_CERTIFICATE, *LPWIN_CERTIFICATE;

Todas as funções ImageHlp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imagehlp.h
Biblioteca Imagehlp.lib
DLL Imagehlp.dll

Confira também

Funções ImageHlp