Função FindExecutableImage (dbghelp.h)

Localiza um arquivo executável.

Para especificar uma função de retorno de chamada, use a função FindExecutableImageEx .

Sintaxe

HANDLE IMAGEAPI FindExecutableImage(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  ImageFilePath
);

Parâmetros

[in] FileName

O nome do arquivo de símbolo a ser localizado. Esse parâmetro pode ser um caminho parcial.

[in] SymbolPath

O caminho onde os arquivos de símbolo estão localizados. Pode ser vários caminhos separados por ponto e vírgula. Para recuperar o caminho do símbolo, use a função SymGetSearchPath .

[out] ImageFilePath

Um ponteiro para um buffer que recebe o caminho completo do arquivo executável.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador aberto para o arquivo executável.

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função FindExecutableImage é fornecida para que os arquivos executáveis possam ser localizados em vários diretórios diferentes por meio de uma única chamada de função. O parâmetro SymbolPath pode conter vários caminhos, com cada um separado por ponto e vírgula (;). Quando vários caminhos são especificados, a função pesquisa cada árvore de diretório para o arquivo executável. Quando o arquivo está localizado, a pesquisa é interrompida. Portanto, especifique SymbolPath com os caminhos na ordem correta.

Todas as funções DbgHelp, 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

Plataforma de Destino	Windows
Cabeçalho	dbghelp.h
Biblioteca	Dbghelp.lib
DLL	Dbghelp.dll
Redistribuível	DbgHelp.dll 5.1 ou posterior

Confira também

Funções DbgHelp

FindExecutableImageEx

SymGetSearchPath