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 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.
Anforderungen
Zielplattform | Windows |
Kopfzeile | dbghelp.h |
Bibliothek | Dbghelp.lib |
DLL | Dbghelp.dll |
Verteilbare Komponente | DbgHelp.dll 5.1 oder höher |