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

Weitere Informationen

DbgHelp-Funktionen

SymSrvStoreSupplement