Fungsi SymSetHomeDirectory (dbghelp.h)

Mengatur direktori beranda yang digunakan oleh Dbghelp.

Sintaks

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

Parameter

[in] hProcess

Handel ke proses. Handel ini sebelumnya harus diteruskan ke fungsi SymInitialize .

[in, optional] dir

Direktori rumah. Direktori ini harus dapat ditulis, jika tidak, direktori beranda adalah direktori aplikasi umum yang ditentukan dengan CSIDL_COMMON_APPDATA. Jika parameter ini NULL, fungsi menggunakan direktori default.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke parameter dir .

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Direktori beranda default adalah direktori tempat Dbghelp.dll berada. Dbghelp menggunakan direktori ini sebagai dasar untuk direktori lain, seperti direktori penyimpanan hilir default (subdirektori sym dari direktori beranda).

Direktori beranda yang digunakan untuk penyimpanan simbol default dan lokasi cache server sumber disimpan dalam variabel lingkungan DBGHELP_HOMEDIR.

Semua fungsi DbgHelp, seperti ini, adalah utas tunggal. Oleh karena itu, panggilan dari lebih dari satu utas ke fungsi ini kemungkinan akan mengakibatkan perilaku tak terduga atau kerusakan memori. Untuk menghindari hal ini, Anda harus menyinkronkan semua panggilan bersamaan dari lebih dari satu utas ke fungsi ini.

Untuk memanggil versi Unicode dari fungsi ini, tentukan DBGHELP_TRANSLATE_TCHAR.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dbghelp.h
Pustaka	Dbghelp.lib
DLL	Dbghelp.dll
Redistribusi	DbgHelp.dll 6.1 atau yang lebih baru

Lihat juga

Fungsi DbgHelp

SymGetHomeDirectory