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 |