SymSetHomeDirectory 函式 (dbghelp.h)

設定 Dbghelp 所使用的主目錄。

語法

PCHAR IMAGEAPI SymSetHomeDirectory(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  dir
);

[in] hProcess

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

[in, optional] dir

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

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

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

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

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

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

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