Fungsi SymEnumSourceLinesW (dbghelp.h)

Artikel
11/20/2024

Menghitung semua baris sumber dalam modul.

Sintaksis

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 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 penunjuk ke struktur data yang menyediakan konteks untuk fungsi panggilan balik.

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

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.

Nota

Header dbghelp.h mendefinisikan SymEnumSourceLines sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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
Redistributable	DbgHelp.dll 6.4 atau yang lebih baru

Lihat juga

DbgHelp Functions

SymEnumLinesProc

SymInitialize

Bagikan melalui