SymSetHomeDirectoryW-Funktion (dbghelp.h)
Legt das von Dbghelp verwendete Startverzeichnis fest.
Syntax
PWSTR IMAGEAPI SymSetHomeDirectoryW(
[in] HANDLE hProcess,
[in, optional] PCWSTR dir
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieser Handle muss zuvor an die SymInitialize Funktion übergeben worden sein.
[in, optional] dir
Das Startverzeichnis. Dieses Verzeichnis muss schreibbar sein, andernfalls ist das Startverzeichnis das gemeinsame Anwendungsverzeichnis, das mit CSIDL_COMMON_APPDATAangegeben ist. Wenn dieser Parameter NULL-ist, verwendet die Funktion das Standardverzeichnis.
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
Das Standardmäßige Startverzeichnis ist das Verzeichnis, in dem sich Dbghelp.dll befindet. Dbghelp verwendet dieses Verzeichnis als Grundlage für andere Verzeichnisse, z. B. das standardmäßige nachgelagerte Speicherverzeichnis (das Sym-Unterverzeichnis des Startverzeichnisses).
Das Startverzeichnis, das für den Standardsymbolspeicher verwendet wird, und der Speicherort des Quellservercaches wird in der umgebungsvariablen DBGHELP_HOMEDIR gespeichert.
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 SymSetHomeDirectory 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 |