Fungsi SymSetOptions (dbghelp.h)
Mengatur opsi mask.
Sintaks
DWORD IMAGEAPI SymSetOptions(
[in] DWORD SymOptions
);
Parameter
[in] SymOptions
Opsi simbol. Nol adalah nilai yang valid dan menunjukkan bahwa semua opsi dinonaktifkan. Nilai opsi digabungkan menggunakan operator OR untuk membentuk nilai opsi yang valid. Berikut ini adalah nilai yang valid.
Nilai | Makna |
---|---|
|
Memungkinkan penggunaan simbol yang disimpan dengan alamat absolut. Sebagian besar simbol disimpan sebagai RVA dari dasar modul. DbgHelp menerjemahkannya ke alamat absolut. Ada simbol yang disimpan sebagai alamat absolut. Ini memiliki tujuan yang sangat khusus dan biasanya tidak digunakan.
DbgHelp 5.1 dan yang lebih lama: Nilai ini tidak didukung. |
|
Mengaktifkan penggunaan simbol yang tidak memiliki alamat. Secara default, DbgHelp memfilter simbol yang tidak memiliki alamat. |
|
Jangan mencari simbol publik saat mencari simbol berdasarkan alamat, atau saat menghitung simbol, kecuali simbol tersebut tidak ditemukan di simbol global atau dalam lingkup saat ini. Opsi ini tidak berpengaruh dengan SYMOPT_PUBLICS_ONLY.
DbgHelp 5.1 dan yang lebih lama: Nilai ini tidak didukung. |
|
Semua pencarian simbol tidak peka terhadap huruf besar/kecil. |
|
Teruskan output debug melalui OutputDebugString atau fungsi panggilan balik SymRegisterCallbackProc64 . |
|
Simbol tidak dimuat sampai referensi dibuat mengharuskan simbol dimuat. Ini adalah cara tercepat dan paling efisien untuk menggunakan penangan simbol. |
|
Menonaktifkan deteksi otomatis penyimpanan server simbol di jalur simbol, bahkan tanpa penunjukan "SRV*", mempertahankan kompatibilitas dengan perilaku sebelumnya.
DbgHelp 6.6 dan yang lebih lama: Nilai ini tidak didukung. |
|
Jangan muat file .pdb yang tidak cocok. Jangan muat simbol ekspor jika semua lainnya gagal. |
|
Jangan tampilkan kotak dialog sistem ketika ada kegagalan media seperti tidak ada media dalam kandar. Sebaliknya, kegagalan terjadi secara diam-diam. |
|
Jika ada file yang tidak dikompresi dan terkompresi yang tersedia, pilih file terkompresi. Opsi ini baik untuk koneksi lambat. |
|
Simbol disimpan di direktori akar penyimpanan hilir default.
DbgHelp 6.1 dan yang lebih lama: Nilai ini tidak didukung. |
|
Abaikan informasi jalur di rekaman CodeView header gambar saat memuat file .pdb. |
|
Abaikan direktori gambar.
DbgHelp 6.1 dan yang lebih lama: Nilai ini tidak didukung. |
|
Jangan gunakan jalur yang ditentukan oleh _NT_SYMBOL_PATH jika pengguna memanggil SymSetSearchPath tanpa jalur yang valid.
DbgHelp 5.1: Nilai ini tidak didukung. |
|
Saat penelusuran kesalahan pada Windows 64-bit, sertakan modul 32-bit apa pun. |
|
Nonaktifkan pemeriksaan untuk memastikan file (.exe, .dbg., atau .pdb) adalah file yang benar. Sebagai gantinya, muat file pertama yang terletak. |
|
Memuat informasi nomor baris. |
|
Semua simbol berhias C++ yang berisi pemisah simbol "::" digantikan oleh "__". Opsi ini ada untuk debugger yang tidak dapat menangani penguraian nama simbol C++ nyata. |
|
Jangan cari gambar untuk jalur simbol saat memuat simbol untuk modul jika header modul tidak dapat dibaca.
DbgHelp 5.1: Nilai ini tidak didukung. |
|
Mencegah meminta validasi dari server simbol. |
|
Jangan cari tabel publik untuk simbol. Opsi ini seharusnya tidak berpengaruh karena ada salinan simbol publik dalam tabel global.
DbgHelp 5.1: Nilai ini tidak didukung. |
|
Mencegah simbol dimuat saat penelepon memeriksa simbol di beberapa modul. Periksa hanya modul yang simbolnya telah dimuat. |
|
Timpa penyimpanan downlevel dari penyimpanan simbol.
DbgHelp 6.1 dan yang lebih lama: Nilai ini tidak didukung. |
|
Jangan gunakan simbol privat. Versi DbgHelp yang dikirim dengan rilis Windows sebelumnya hanya mendukung simbol publik; opsi ini memberikan kompatibilitas dengan batasan ini.
DbgHelp 5.1: Nilai ini tidak didukung. |
|
DbgHelp tidak akan memuat server simbol apa pun selain SymSrv. SymSrv tidak akan menggunakan penyimpanan hilir yang ditentukan dalam _NT_SYMBOL_PATH. Setelah bendera ini ditetapkan, bendera tidak dapat dibersihkan.
DbgHelp 6.0 dan 6.1: Bendera ini dapat dibersihkan. DbgHelp 5.1: Nilai ini tidak didukung. |
|
Semua simbol disajikan dalam bentuk yang tidak terdekorasi.
Opsi ini tidak berpengaruh pada simbol global atau lokal karena disimpan tidak terdekorasi. Opsi ini hanya berlaku untuk simbol publik. |
Mengembalikan nilai
Fungsi mengembalikan mask opsi saat ini.
Keterangan
Nilai opsi dapat diubah beberapa kali saat pustaka sedang digunakan oleh aplikasi. Perubahan opsi memengaruhi semua panggilan di masa mendatang ke penangan simbol.
Untuk mendapatkan mask opsi saat ini, panggil fungsi SymGetOptions .
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.
Contoh
Misalnya, lihat Menginisialisasi Penangan Simbol.
Persyaratan
Target Platform | Windows |
Header | dbghelp.h |
Pustaka | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribusi | DbgHelp.dll 5.1 atau yang lebih baru |