FindExecutableImage-Funktion (dbghelp.h)

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 Symboldatei, die gefunden werden soll. Dieser Parameter kann ein partieller Pfad sein.

[in] SymbolPath

Der Pfad, in dem sich Symboldateien befinden. Dies kann mehrere Pfade sein, die durch Semikolons getrennt werden. Verwenden Sie die SymGetSearchPath-Funktion , um den Symbolpfad abzurufen.

[out] ImageFilePath

Ein Zeiger auf einen Puffer, der den vollständigen Pfad der ausführbaren Datei empfängt. Dieser Puffer muss mindestens MAX_PATH+1 Zeichen sein.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Die Funktion FindExecutableImage wird bereitgestellt, sodass ausführbare Dateien in mehreren verschiedenen Verzeichnissen über einen einzelnen Funktionsaufruf gespeichert werden können. Der Parameter "SymbolPath" kann mehrere Pfade enthalten, wobei jeder durch ein Semikolon (;)) getrennt ist. Wenn mehrere Pfade angegeben werden, 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 single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, müssen Sie alle gleichzeitigen Aufrufe von mehr als einem Thread mit dieser Funktion synchronisieren.

Requirements

Siehe auch

DbgHelp-Funktionen

FindExecutableImageEx

SymGetSearchPath