Fungsi SymAddSymbolW (dbghelp.h)

  • Artikel

Menambahkan simbol virtual ke modul yang ditentukan.

Sintaks

BOOL IMAGEAPI SymAddSymbolW(
  [in] HANDLE  hProcess,
  [in] ULONG64 BaseOfDll,
  [in] PCWSTR  Name,
  [in] DWORD64 Address,
  [in] DWORD   Size,
  [in] DWORD   Flags
);

Parameter

[in] hProcess

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

[in] BaseOfDll

Alamat dasar modul.

[in] Name

Nama simbol. Ukuran maksimum nama simbol adalah MAX_SYM_NAME karakter.

[in] Address

Alamat simbol . Alamat ini harus berada dalam rentang alamat modul yang ditentukan.

[in] Size

Ukuran simbol, dalam byte. Parameter ini bersifat opsional.

[in] Flags

Parameter ini tidak digunakan.

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

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.

Catatan

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

   
Target Platform Windows
Header dbghelp.h
Pustaka Dbghelp.lib
DLL Dbghelp.dll
Redistribusi DbgHelp.dll 6.0 atau yang lebih baru

Lihat juga

Fungsi DbgHelp

SymDeleteSymbol