FindExecutableImage-Funktion (dbghelp.h)

Artikel
08/23/2023

Sucht eine ausführbare Datei.

Verwenden Sie die Funktion FindExecutableImageEx , um eine Rückruffunktion anzugeben.

Syntax

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

Parameter

[in] FileName

Der Name der zu findenden Symboldatei. Dieser Parameter kann ein Teilpfad sein.

[in] SymbolPath

Der Pfad, in dem sich Symboldateien befinden. Dies können mehrere Pfade sein, die durch Semikolons getrennt sind. Verwenden Sie zum Abrufen des Symbolpfads die SymGetSearchPath-Funktion .

[out] ImageFilePath

Ein Zeiger auf einen Puffer, der den vollständigen Pfad der ausführbaren Datei empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein geöffnetes Handle für die ausführbare Datei.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die FindExecutableImage-Funktion wird bereitgestellt, damit ausführbare Dateien über einen einzelnen Funktionsaufruf in mehreren verschiedenen Verzeichnissen gefunden werden können. Der SymbolPath-Parameter kann mehrere Pfade enthalten, wobei jeder durch ein Semikolon (;). Wenn mehrere Pfade angegeben sind, durchsucht die Funktion jede Verzeichnisstruktur nach der ausführbaren Datei. Wenn sich die Datei befindet, wird die Suche beendet. Achten Sie daher darauf, SymbolPath mit den Pfaden in der richtigen Reihenfolge anzugeben.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.