Fungsi SymGetSourceFileW (dbghelp.h)

Mengambil file sumber yang ditentukan dari server sumber.

Sintaks

BOOL IMAGEAPI SymGetSourceFileW(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCWSTR  Params,
  [in]           PCWSTR  FileSpec,
  [out]          PWSTR   FilePath,
  [in]           DWORD   Size
);

Parameter

[in] hProcess

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

[in] Base

Alamat dasar modul.

[in, optional] Params

Parameter ini tidak digunakan.

[in] FileSpec

Nama file sumber.

[out] FilePath

Penunjuk ke buffer yang menerima jalur file sumber yang sepenuhnya memenuhi syarat.

[in] Size

Ukuran buffer FilePath , dalam karakter.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

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

Keterangan

Untuk mengontrol direktori mana yang menerima file sumber, gunakan fungsi SymSetHomeDirectory .

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.

Catatan

Header dbghelp.h mendefinisikan SymGetSourceFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

DbgHelp Functions

Server sumber