Função ImageGetDigestStream (imagehlp.h)

Recupera os dados solicitados do arquivo de imagem especificado.

Sintaxe

BOOL IMAGEAPI ImageGetDigestStream(
  [in] HANDLE          FileHandle,
  [in] DWORD           DigestLevel,
  [in] DIGEST_FUNCTION DigestFunction,
  [in] DIGEST_HANDLE   DigestHandle
);

Parâmetros

[in] FileHandle

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

[in] DigestLevel

Os aspectos da imagem que devem ser incluídos no fluxo de dados retornado. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO
0x04
Inclua todas as informações de importação.
CERT_PE_IMAGE_DIGEST_DEBUG_INFO
0x01
Inclua informações simbólicas de depuração.
CERT_PE_IMAGE_DIGEST_RESOURCES
0x02
Inclua informações de recurso.

[in] DigestFunction

Um ponteiro para uma rotina de retorno de chamada para processar os dados. Para obter mais informações, consulte DigestFunction.

[in] DigestHandle

Um identificador fornecido pelo usuário para o resumo. Esse parâmetro é passado para DigestFunction como o primeiro argumento.

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 função ImageGetDigestStream retorna os dados a serem digeridos de um arquivo de imagem especificado, sujeito ao parâmetro DigestLevel passado. A ordem dos bytes será consistente para chamadas diferentes, o que é necessário para garantir que o mesmo resumo da mensagem seja sempre produzido do fluxo de bytes recuperado.

Para garantir a compatibilidade entre plataformas, todas as implementações dessa função devem se comportar de maneira consistente em relação à ordem em que as várias partes do arquivo de imagem são retornadas.

Os dados devem ser retornados na seguinte ordem:

  1. Informações de imagem (dados executáveis e estáticos).
  2. Dados do recurso.
  3. Informações de depuração.
Se alguma delas não for especificada, as partes restantes deverão ser retornadas na mesma ordem.

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