Metode IDebugEventCallbacks::SessionStatus (dbgeng.h)

  • Artikel

Metode panggilan balik SessionStatus dipanggil oleh mesin ketika perubahan terjadi di sesi debugger.

Sintaks

HRESULT SessionStatus(
  [in] ULONG Status
);

Parameter

[in] Status

Menentukan status baru sesi debugger. Tabel berikut menjelaskan nilai yang mungkin.

Nilai Deskripsi
DEBUG_SESSION_ACTIVE Sesi debugger telah dimulai.
DEBUG_SESSION_END_SESSION_ACTIVE_TERMINATE Sesi berakhir dengan mengirim DEBUG_END_ACTIVE_TERMINATE ke EndSession.
DEBUG_SESSION_END_SESSION_ACTIVE_DETACH Sesi berakhir dengan mengirim DEBUG_END_ACTIVE_DETACH ke EndSession.
DEBUG_SESSION_END_SESSION_PASSIVE Sesi berakhir dengan mengirim DEBUG_END_PASSIVE ke EndSession.
DEBUG_SESSION_END Target berjalan hingga selesai, mengakhiri sesi.
DEBUG_SESSION_REBOOT Komputer target di-boot ulang, mengakhiri sesi.
DEBUG_SESSION_HIBERNATE Komputer target masuk ke hibernasi, mengakhiri sesi.
DEBUG_SESSION_FAILURE Mesin tidak dapat melanjutkan sesi.

Nilai kembali

Nilai pengembalian metode ini diabaikan oleh mesin.

Keterangan

Metode ini hanya dipanggil oleh mesin jika bendera DEBUG_EVENT_SESSION_STATUS diatur dalam masker yang dikembalikan oleh IDebugEventCallbacks::GetInterestMask.

Setelah mesin memberi tahu semua panggilan balik peristiwa tentang perubahan status sesi, mesin juga akan memberi tahu ekstensi yang dimuat yang mengekspor metode panggilan balik DebugExtensionNotify . Nilai yang diteruskannya ke ekstensi tergantung pada nilai Status. Jika Status DEBUG_SESSION_ACTIVE, status akan melewati DEBUG_SESSION_ACTIVE; jika tidak, itu melewati DEBUG_SESSION_INACTIVE.

Dalam kasus DEBUG_SESSION_ACTIVE, mesin mengikuti pemberitahuan perubahan sesi debugger dengan pemberitahuan perubahan status target dengan memanggil IDebugEventCallbacks::ChangeDebuggeeState pada panggilan balik peristiwa dan meneruskan DEBUG_CDS_ALL di parameter Bendera . Dalam semua kasus lain, mesin mendahului pemberitahuan ini dengan pemberitahuan perubahan status mesin dengan memanggil IDebugEventCallbacks::ChangeEngineState pada panggilan balik peristiwa dan meneruskan DEBUG_CES_EXECUTION_STATUS dalam parameter Bendera .

Untuk informasi selengkapnya tentang menangani peristiwa, lihat Memantau Peristiwa. Untuk informasi tentang sesi debugger, lihat Sesi Debugging dan Model Eksekusi.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)