Função ImageEnumerateCertificates (imagehlp.h)
Recupera informações sobre os certificados atualmente contidos em um arquivo de imagem.
Sintaxe
BOOL IMAGEAPI ImageEnumerateCertificates(
[in] HANDLE FileHandle,
[in] WORD TypeFilter,
[out] PDWORD CertificateCount,
[in, out] PDWORD Indices,
[in, optional] DWORD IndexCount
);
Parâmetros
[in] FileHandle
Um identificador para o arquivo de imagem a ser examinado. Esse identificador deve ser aberto para acesso FILE_READ_DATA.
[in] TypeFilter
O tipo de seção de certificado a ser usado como um filtro ao retornar informações de certificado. CERT_SECTION_TYPE_ANY deve ser passado para obter informações sobre todos os tipos de seção presentes na imagem.
[out] CertificateCount
Um ponteiro para uma variável que recebe o número de certificados na imagem que contém seções do tipo especificado pelo parâmetro TypeFilter . Se nenhum for encontrado, esse parâmetro será zero.
[in, out] Indices
Opcionalmente, fornece um buffer a ser usado para retornar uma matriz de índices para os certificados que contêm seções do tipo especificado. Nenhuma ordenação deve ser assumida para os valores de índice, nem elas têm garantia de serem contíguas quando CERT_SECTION_TYPE_ANY é consultada.
[in, optional] IndexCount
O tamanho do buffer índices , em DWORDs. Esse parâmetro será examinado sempre que Índices estiverem presentes. Se CertificateCount for maior que IndexCount, Os índices serão preenchidos com as primeiras seções IndexCount encontradas na imagem; quaisquer outras não serão retornadas.
Valor retornado
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 função ImageEnumerateCertificates retorna informações sobre os certificados atualmente contidos em um arquivo de imagem. Ele tem recursos de filtragem que permitem que certificados que contêm seções de qualquer tipo único (ou de qualquer tipo) sejam retornados.
Depois que os índices de certificados interessantes forem descobertos, eles poderão ser passados para a função ImageGetCertificateData para obter os corpos reais dos certificados.
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
| 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 |