Bagikan melalui

Fungsi SymSrvDeltaName (dbghelp.h)

  • Artikel

Menghasilkan nama untuk file yang menjelaskan hubungan antara dua versi berbeda dari simbol atau file gambar yang sama. Menggunakan fitur ini mencegah aplikasi harus meregenerasi informasi tersebut setiap kali menganalisis dua file.

Sintaks

PCSTR IMAGEAPI SymSrvDeltaName(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  Type,
  [in]           PCSTR  File1,
  [in]           PCSTR  File2
);

Parameter

[in] hProcess

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

[in, optional] SymPath

Jalur simbol. Fungsi ini hanya menggunakan penyimpanan simbol yang dijelaskan dalam sintaks standar untuk penyimpanan simbol. Semua jalur lainnya diabaikan. Jika parameter ini NULL, fungsi menggunakan jalur simbol yang diatur menggunakan fungsi SymInitialize atau SymSetSearchPath .

[in] Type

Ekstensi untuk nama file yang dihasilkan.

[in] File1

Jalur versi pertama dari file simbol atau gambar.

[in] File2

Jalur versi kedua dari simbol atau file gambar.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nama file yang dihasilkan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Fungsi ini membuka dua file yang ditentukan, membaca informasi pengindeksan dari header, dan meneruskan informasi ini ke server simbol sehingga dapat membuat nama file. Jika Anda menentukan parameter Jenis sebagai "xml", namanya adalah indeks File1, diikuti dengan tanda hubung, diikuti oleh indeks File2, diikuti dengan ekstensi .xml. Contohnya:

3F3D5C755000-3F3D647621000.xml

Fungsi ini mengembalikan penunjuk ke buffer yang mungkin digunakan kembali oleh fungsi lain. Oleh karena itu, pastikan untuk segera menyalin data yang dikembalikan ke buffer lain.

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

   
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