SymSrvGetSupplementW-Funktion (dbghelp.h)
Ruft die angegebene Datei aus der Ergänzung für einen Symbolspeicher ab.
Syntax
PCWSTR IMAGEAPI SymSrvGetSupplementW(
[in] HANDLE hProcess,
[in, optional] PCWSTR SymPath,
[in] PCWSTR Node,
[in] PCWSTR File
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieser Handle muss zuvor an die SymInitialize Funktion übergeben worden sein.
[in, optional] SymPath
Der Symbolpfad. Die Funktion verwendet nur die in der Standardsyntax beschriebenen Symbolspeicher für Symbolspeicher. Alle anderen Pfade werden ignoriert. Wenn dieser Parameter NULL-ist, verwendet die Funktion den Symbolpfad, der mithilfe der SymInitialize oder SymSetSearchPath--Funktion festgelegt wurde.
[in] Node
Die Symboldatei, die der ergänzenden Datei zugeordnet ist.
[in] File
Der Name der Datei.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vollqualifizierte Pfad für die ergänzende Datei.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.
Bemerkungen
Weitere Informationen zu ergänzenden Dateien finden Sie unter SymSrvStoreSupplement.
Diese Funktion gibt einen Zeiger auf einen Puffer zurück, der von einer anderen Funktion wiederverwendet werden kann. Achten Sie daher darauf, die daten, die sofort in einen anderen Puffer zurückgegeben wurden, zu kopieren.
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 SymSrvGetSupplement 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 6.3 oder höher |