FindExecutableImageExW-Funktion (dbghelp.h)
Sucht die angegebene ausführbare Datei.
Syntax
HANDLE IMAGEAPI FindExecutableImageExW(
[in] PCWSTR FileName,
[in] PCWSTR SymbolPath,
[out] PWSTR ImageFilePath,
[in, optional] PFIND_EXE_FILE_CALLBACKW Callback,
[in, optional] PVOID CallerData
);
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. Diese Zeichenfolge kann mehrere Pfade enthalten, 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.
[in, optional] Callback
Eine anwendungsdefinierte Rückruffunktion, die überprüft, ob die richtige ausführbare Datei gefunden wurde oder ob die Funktion die Suche fortsetzen soll. Weitere Informationen finden Sie unter FindExecutableImageProc.
Dieser Parameter kann NULL-sein.
[in, optional] CallerData
Optionale benutzerdefinierte Daten für die Rückruffunktion. Dieser Parameter kann NULL-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 FindExecutableImageEx wird bereitgestellt, sodass ausführbare Dateien in mehreren verschiedenen Verzeichnissen mithilfe eines einzelnen Funktionsaufrufs gefunden werden können. Wenn der SymbolPath Parameter mehrere Pfade enthält, durchsucht die Funktion jede angegebene Verzeichnisstruktur nach der ausführbaren Datei. Wenn die Datei gefunden wird, 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.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anmerkung
Der dbghelp.h-Header definiert FindExecutableImageEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | dbghelp.h |
| Library | Dbghelp.lib |
| DLL- | Dbghelp.dll |
| redistributable | DbgHelp.dll 5.1 oder höher |