SymSetHomeDirectoryW 函式（dbghelp.h）

設定 Dbghelp 所使用的主目錄。

語法

PWSTR IMAGEAPI SymSetHomeDirectoryW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR dir
);

[in] hProcess

進程的句柄。此句柄先前必須傳遞至 SymInitialize 函式。

[in, optional] dir

主目錄。此目錄必須可寫入，否則主目錄是使用 CSIDL_COMMON_APPDATA指定的通用應用程式目錄。如果此參數 NULL，則函式會使用預設目錄。

如果函式成功，傳回值是 dir 參數的指標。

如果函式失敗，則傳回值 NULL。若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

預設主目錄是 Dbghelp.dll 所在的目錄。 Dbghelp 會使用此目錄作為其他目錄的基礎，例如預設的下游存放區目錄（主目錄的符號子目錄）。

用於預設符號存放區和來源伺服器快取位置的主目錄會儲存在DBGHELP_HOMEDIR環境變數中。

所有 DbgHelp 函式，例如此函式，都是單個線程。因此，從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。若要避免這種情況，您必須將多個線程的所有並行呼叫同步至此函式。

若要呼叫此函式的 Unicode 版本，請定義DBGHELP_TRANSLATE_TCHAR。

注意

dbghelp.h 標頭會將 SymSetHomeDirectory 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。