Fungsi SymGetSourceFileW (dbghelp.h)
Mengambil file sumber yang ditentukan dari server sumber.
Sintaksis
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
[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
Mengembalikan nilai
Jika fungsi berhasil, nilai pengembalian TRUE.
Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Komentar
Untuk mengontrol direktori mana yang menerima file sumber, gunakan fungsi
Semua fungsi DbgHelp, seperti yang ini, berutas 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.
Nota
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
| Syarat | Nilai |
|---|---|
| Platform Target |
Windows |
| Header |
dbghelp.h |
| Pustaka |
Dbghelp.lib |
| DLL |
Dbghelp.dll |
| |
DbgHelp.dll 6.2 atau yang lebih baru |
Lihat juga
Server Sumber