Fungsi SymFindFileInPath (dbghelp.h)

Artikel
08/23/2023

Menemukan file simbol atau gambar yang dapat dieksekusi.

Sintaks

BOOL IMAGEAPI SymFindFileInPath(
  [in]           HANDLE                  hprocess,
  [in, optional] PCSTR                   SearchPath,
  [in]           PCSTR                   FileName,
  [in, optional] PVOID                   id,
  [in]           DWORD                   two,
  [in]           DWORD                   three,
  [in]           DWORD                   flags,
  [out]          PSTR                    FoundFile,
  [in, optional] PFINDFILEINPATHCALLBACK callback,
  [in, optional] PVOID                   context
);

Parameter

[in] hprocess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in, optional] SearchPath

Jalur pencarian. Ini bisa menjadi beberapa jalur yang dipisahkan oleh titik koma. Ini dapat mencakup direktori dan server simbol. Jika parameter ini NULL, fungsi menggunakan jalur pencarian yang diatur menggunakan fungsi SymSetSearchPath atau SymInitialize .

[in] FileName

Nama file. Anda dapat menentukan jalur; namun, hanya nama file yang digunakan.

[in, optional] id

Yang pertama dari tiga parameter identifikasi (lihat Keterangan).

[in] two

Yang kedua dari tiga parameter identifikasi (lihat Keterangan).

[in] three

Yang ketiga dari tiga parameter identifikasi (lihat Keterangan).

[in] flags

Format parameter id . Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
SSRVOPT_DWORD 0x0002	Parameter id adalah DWORD.
SSRVOPT_DWORDPTR 0x0004	Parameter id adalah penunjuk ke DWORD.
SSRVOPT_GUIDPTR 0x0008	Parameter id adalah penunjuk ke GUID.

[out] FoundFile

Penunjuk ke buffer yang menerima jalur yang sepenuhnya memenuhi syarat ke file simbol. Buffer ini setidaknya harus MAX_PATH karakter.

[in, optional] callback

Fungsi panggilan balik SymFindFileInPathProc .

[in, optional] context

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

Mengembalikan nilai

Jika server menemukan file simbol yang valid, server mengembalikan TRUE; jika tidak, mengembalikan FALSE dan GetLastError mengembalikan nilai yang menunjukkan mengapa file simbol tidak dikembalikan.

Keterangan

Parameter identifikasi diisi sebagai berikut:

Jika DbgHelp mencari file .pdb, parameter id menentukan tanda tangan PDB seperti yang ditemukan di direktori debug codeview dari gambar asli. Parameter dua menentukan usia PDB. Parameter tiga tidak digunakan dan diatur ke nol.
Jika DbgHelp mencari jenis gambar lainnya, seperti file yang dapat dieksekusi atau file .dbg, parameter id menentukan TimeDateStamp dari gambar asli seperti yang ditemukan di header PE-nya. Parameter dua menentukan bidang SizeOfImage, juga diekstrak dari header PE. Parameter tiga tidak digunakan dan diatur ke nol.

Semua nilai ini dapat diperoleh dengan memanggil SymSrvGetFileIndexInfo.

Saat mencari direktori, fungsi ini tidak memverifikasi bahwa pengidentifikasi simbol cocok secara default. Untuk memastikan file simbol yang cocok berada, panggil fungsi SymSetOptions dengan SYMOPT_EXACT_SYMBOLS.

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.