Fungsi SymEnumSourceLinesW (dbghelp.h)

Artikel
03/11/2023

Menghitung semua baris sumber dalam modul.

Sintaks

BOOL IMAGEAPI SymEnumSourceLinesW(
  [in]           HANDLE                   hProcess,
  [in]           ULONG64                  Base,
  [in, optional] PCWSTR                   Obj,
  [in, optional] PCWSTR                   File,
  [in, optional] DWORD                    Line,
  [in]           DWORD                    Flags,
  [in]           PSYM_ENUMLINES_CALLBACKW EnumLinesCallback,
  [in, optional] PVOID                    UserContext
);

Parameter

[in] hProcess

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

[in] Base

Alamat dasar modul.

[in, optional] Obj

Nama file .obj dalam modul. Cakupan enumerasi terbatas pada file ini. Jika parameter ini NULL atau string kosong, semua file .obj akan dicari.

[in, optional] File

Ekspresi kartubebas yang menunjukkan nama file sumber yang akan dicari. Jika parameter ini NULL atau string kosong, semua file akan dicari.

[in, optional] Line

Nomor baris baris dalam modul. Cakupan enumerasi terbatas pada baris ini. Jika parameter ini adalah 0, semua baris akan dicari.

[in] Flags

Jika parameter ini ESLFLAG_FULLPATH, fungsi cocok dengan jalur lengkap dalam parameter File .

[in] EnumLinesCallback

Fungsi panggilan balik SymEnumLinesProc yang menerima informasi baris.

[in, optional] UserContext

Nilai yang ditentukan pengguna yang diteruskan ke fungsi panggilan balik, atau NULL. Parameter ini biasanya digunakan oleh aplikasi untuk meneruskan pointer ke struktur data yang menyediakan konteks untuk fungsi panggilan balik.

Nilai kembali

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

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.

Catatan

Header dbghelp.h mendefinisikan SymEnumSourceLines sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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.