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

Confira também

ImageGetCertificateData

Funções ImageHlp