Fungsi SymSetContext (dbghelp.h)

Artikel
02/28/2024

Mengatur informasi konteks yang digunakan oleh fungsi SymEnumSymbols . Fungsi ini hanya berfungsi dengan simbol PDB.

Sintaks

BOOL IMAGEAPI SymSetContext(
  [in]           HANDLE                hProcess,
  [in]           PIMAGEHLP_STACK_FRAME StackFrame,
  [in, optional] PIMAGEHLP_CONTEXT     Context
);

Parameter

[in] hProcess

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

[in] StackFrame

Penunjuk ke struktur IMAGEHLP_STACK_FRAME yang berisi informasi bingkai.

[in, optional] Context

Parameter diabaikan

Nilai kembali

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

Jika Anda memanggil SymSetContext untuk mengatur konteks ke nilainya saat ini, fungsi gagal tetapi GetLastError mengembalikan ERROR_SUCCESS.

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.