Fungsi SymSrvGetFileIndexString (dbghelp.h)

Artikel
02/29/2024

Mengambil string indeks untuk file .pdb, .dbg, atau gambar yang ditentukan.

Sintaks

BOOL IMAGEAPI SymSrvGetFileIndexString(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  File,
  [out]          PSTR   Index,
  [in]           size_t Size,
  [in]           DWORD  Flags
);

Parameter

[in] hProcess

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

[in, optional] SrvPath

Jalur ke server simbol.

[in] File

Nama file.

[out] Index

Penunjuk ke buffer yang menerima string indeks.

[in] Size

Ukuran buffer Indeks , dalam karakter.

[in] Flags

Parameter ini dicadangkan untuk digunakan di masa mendatang.

Mengembalikan nilai

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

Fungsi ini bukan untuk penggunaan umum. Utilitas penulisan untuk pengelolaan file di penyimpanan server simbol dapat digunakan untuk fungsi ini untuk memprediksi jalur relatif server simbol akan mencari file. Ini digunakan oleh srctool.exe untuk benar-benar mengisi penyimpanan server simbol.

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.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dbghelp.h
Pustaka	DbgHelp.lib
DLL	DbgHelp.dll
Redistribusi	DbgHelp.dll 6.3 atau yang lebih baru

Lihat juga

Fungsi DbgHelp

Bagikan melalui