Freigeben über


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

Siehe auch

DbgHelp-Funktionen

SymSrvStoreSupplement