SymGetHomeDirectoryW-Funktion (dbghelp.h)

Artikel
11/20/2024

Ruft das von Dbghelp verwendete Startverzeichnis ab.

Syntax

PWSTR IMAGEAPI SymGetHomeDirectoryW(
  [in]  DWORD  type,
  [out] PWSTR  dir,
  [in]  size_t size
);

Parameter

[in] type

Das abzurufende Verzeichnis. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
hdBase- 0	Das Startverzeichnis.
hdSrc 2	Das Quellverzeichnis.
hdSym- 1	Das Symbolverzeichnis.

[out] dir

Ein Zeiger auf eine Zeichenfolge, die das Verzeichnis empfängt.

[in] size

Die Größe des Ausgabepuffers in Zeichen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf den dir Parameter.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

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 SymGetHomeDirectory als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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.1 oder höher

Siehe auch

DbgHelp-Funktionen

SymSetHomeDirectory

Freigeben über