Fungsi SymGetHomeDirectory (dbghelp.h)

Mengambil direktori beranda yang digunakan oleh Dbghelp.

Sintaks

PCHAR IMAGEAPI SymGetHomeDirectory(
  [in]  DWORD  type,
  [out] PSTR   dir,
  [in]  size_t size
);

Parameter

[in] type

Direktori yang akan diambil. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
hdBase 0	Direktori rumah.
hdSrc 2	Direktori sumber.
hdSym 1	Direktori simbol.

[out] dir

Penunjuk ke string yang menerima direktori.

[in] size

Ukuran buffer output, dalam karakter.

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

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

SymSetHomeDirectory