Compartilhar via


Função BindImage (imagehlp.h)

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

Essa função foi substituída pela função BindImageEx . Use BindImageEx para fornecer uma rotina status ou sinalizadores para controlar a associação de imagem.

Sintaxe

BOOL IMAGEAPI BindImage(
  [in] PCSTR ImageName,
  [in] PCSTR DllPath,
  [in] PCSTR SymbolPath
);

Parâmetros

[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.

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

Uma chamada para BindImage é equivalente à seguinte chamada: BindImageEx( 0, ImageName, DllPath, SymbolPath, NULL );

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

BindImageEx

Funções ImageHlp