Metode IDebugClient5::SetEventCallbacksWide (dbgeng.h)

Artikel
02/23/2024

Metode SetEventCallbacksWide mendaftarkan objek panggilan balik peristiwa dengan klien ini.

Sintaks

HRESULT SetEventCallbacksWide(
  [in] PDEBUG_EVENT_CALLBACKS_WIDE Callbacks
);

Parameter

[in] Callbacks

Menentukan penunjuk antarmuka ke objek panggilan balik peristiwa untuk mendaftar dengan klien ini.

Nilai kembali

Bergantung pada implementasi metode IDebugEventCallbacks::GetInterestMask dalam objek yang ditentukan oleh Callbacks, nilai lain dapat dikembalikan, seperti yang dijelaskan di bagian Keterangan.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Jika nilai Callback bukan NULL, metode IDebugEventCallbacks::GetInterestMask dipanggil. Jika nilai yang dikembalikan tidak S_OK, SetEventCallbacks dan SetEventCallbacksWide tidak berpengaruh dan mengembalikan nilai ini.

Setiap klien dapat memiliki paling banyak satu objek IDebugEventCallbacks atau IDebugEventCallbacksWide yang terdaftar di dalamnya untuk menerima peristiwa.

Antarmuka IDebugEventCallbacksWide memperluas antarmuka COM IUnknown. Ketika SetEventCallbacks dan SetEventCallbacksWide berhasil, mereka memanggil metode IUnknown::AddRef dari objek yang ditentukan oleh Callbacks. Metode IUnknown::Release objek ini akan dipanggil lain kali SetEventCallbacks atau SetEventCallbacksWide dipanggil pada klien ini, atau ketika klien ini dihapus.

Untuk informasi selengkapnya tentang panggilan balik, lihat Panggilan balik.