Função BindImageEx (imagehlp.h)

Calcula o endereço virtual de cada função importada.

Sintaxe

BOOL IMAGEAPI BindImageEx(
  [in] DWORD                    Flags,
  [in] PCSTR                    ImageName,
  [in] PCSTR                    DllPath,
  [in] PCSTR                    SymbolPath,
  [in] PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

Parâmetros

[in] Flags

As opções de associação. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
BIND_ALL_IMAGES 0x00000004	Associe todas as imagens na árvore de chamadas para esse arquivo.
BIND_CACHE_IMPORT_DLLS 0x00000008	Não descarte informações de DLL no cache entre chamadas. Isso melhora o desempenho ao associar um grande número de imagens.
BIND_NO_BOUND_IMPORTS 0x00000001	Não gere uma nova tabela de endereços de importação.
BIND_NO_UPDATE 0x00000002	Não faça alterações no arquivo.

[in] ImageName

O nome do arquivo a ser associado. Esse valor pode ser um nome de arquivo, um caminho parcial ou um caminho completo.

[in] DllPath

A raiz do caminho de pesquisa a ser usado se o arquivo especificado pelo parâmetro ImageName não puder ser aberto.

[in] SymbolPath

A raiz do caminho para pesquisar o arquivo de símbolo correspondente do arquivo.

[in] StatusRoutine

Um ponteiro para uma rotina status. A rotina status é chamada durante o progresso da associação de imagem. Para obter mais informações, consulte StatusRoutine.

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

O processo de associação de uma imagem consiste em calcular o endereço virtual de cada função importada. Em seguida, o endereço virtual computado é salvo na IAT (Tabela de Endereços de Importação) da imagem de importação. Como resultado, a imagem é carregada muito mais rapidamente, especialmente se ela usa muitas DLLs, porque o carregador do sistema não precisa calcular o endereço de cada função importada.

Se um arquivo de símbolo correspondente puder ser localizado, seu carimbo de data/hora e soma de verificação serão atualizados.

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

Funções ImageHlp

StatusRoutine