SymSrvGetSupplement-Funktion (dbghelp.h)
Ruft die angegebene Datei aus der Ergänzung für einen Symbolspeicher ab.
Syntax
PCSTR IMAGEAPI SymSrvGetSupplement(
[in] HANDLE hProcess,
[in, optional] PCSTR SymPath,
[in] PCSTR Node,
[in] PCSTR File
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieses 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 Funktion SymInitialize oder SymSetSearchPath festgelegt wurde.
[in] Node
Die Symboldatei, die der zusätzlichen 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 zusätzliche Datei.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Weitere Informationen zu zusätzlichen Dateien finden Sie unter SymSrvStoreSupplement.
Diese Funktion gibt einen Zeiger auf einen Puffer zurück, der von einer anderen Funktion wiederverwendet werden kann. Kopieren Sie daher unbedingt die zurückgegebenen Daten sofort in einen anderen Puffer.
Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. 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.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Bibliothek | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Verteilbare Komponente | DbgHelp.dll Version 6.3 oder höher |