SymSetHomeDirectoryW-Funktion (dbghelp.h)
Legt das home-Verzeichnis fest, das von Dbghelp verwendet wird.
Syntax
PWSTR IMAGEAPI SymSetHomeDirectoryW(
[in] HANDLE hProcess,
[in, optional] PCWSTR dir
);
Parameter
[in] hProcess
Ein Handle zu einem Prozess. Dieser Handle muss zuvor an die SymInitialize-Funktion übergeben werden.
[in, optional] dir
Das Startverzeichnis. Dieses Verzeichnis muss schreibbar sein, andernfalls ist das startverzeichnis das allgemeine Anwendungsverzeichnis, das mit CSIDL_COMMON_APPDATA angegeben 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. Um erweiterte Fehlerinformationen abzurufen, rufen Sie GetLastError auf.
Bemerkungen
Das Standardmäßige Startverzeichnis ist das Verzeichnis, in dem Dbghelp.dll befindet. Dbghelp verwendet dieses Verzeichnis als Basis für andere Verzeichnisse, z. B. das Standardspeicherverzeichnis (das Sym-Unterverzeichnis des Startverzeichniss).
Das Startverzeichnis, das für den Standardsymbolspeicher verwendet wird, und der Speicherort des Quellservercaches wird in der DBGHELP_HOMEDIR Umgebungsvariable gespeichert.
Alle DbgHelp-Funktionen, wie z. B. dieses, sind einzelne Threade. 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.
Hinweis
Der dbghelp.h-Header definiert SymSetHomeDirectory als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Bibliothek | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Verteilbare Komponente | DbgHelp.dll 6.1 oder höher |