Метод IDebugEventCallbacks::SessionStatus (dbgeng.h)

Метод обратного вызова SessionStatus вызывается подсистемой при изменении сеанса отладчика.

Синтаксис

HRESULT SessionStatus(
  [in] ULONG Status
);

Параметры

[in] Status

Указывает новое состояние сеанса отладчика. В следующей таблице описаны возможные значения.

Ценность Описание
DEBUG_SESSION_ACTIVE Запущен сеанс отладчика.
DEBUG_SESSION_END_SESSION_ACTIVE_TERMINATE Сеанс закончился отправкой DEBUG_END_ACTIVE_TERMINATE в EndSession.
DEBUG_SESSION_END_SESSION_ACTIVE_DETACH Сеанс закончился путем отправки DEBUG_END_ACTIVE_DETACH в EndSession.
DEBUG_SESSION_END_SESSION_PASSIVE Сеанс закончился отправкой DEBUG_END_PASSIVE в EndSession.
DEBUG_SESSION_END Целевой объект выполнен до завершения, завершив сеанс.
DEBUG_SESSION_REBOOT Целевой компьютер перезагрузился, завершив сеанс.
DEBUG_SESSION_HIBERNATE Целевой компьютер вошел в режим гибернации, завершив сеанс.
DEBUG_SESSION_FAILURE Подсистема не смогла продолжить сеанс.

Возвращаемое значение

Возвращаемое значение этого метода игнорируется подсистемой.

Замечания

Этот метод вызывается только подсистемой, если флаг DEBUG_EVENT_SESSION_STATUS задан в маске, возвращаемой IDebugEventCallbacks::GetInterestMask.

После уведомления всех обратных вызовов события в состоянии сеанса обработчик также уведомит все загруженные расширения , экспортируемые метод обратного вызова DebugExtensionNotify . Значение, которое оно передает расширениям, зависит от значения status. Если состояние DEBUG_SESSION_ACTIVE, оно проходит DEBUG_SESSION_ACTIVE; в противном случае он передает DEBUG_SESSION_INACTIVE.

В DEBUG_SESSION_ACTIVE случае подсистема следует уведомлению об изменении сеанса отладчика с уведомлением об изменении целевого состояния путем вызова IDebugEventCallbacks::ChangeDebuggeeState на обратных вызовах событий и передачи DEBUG_CDS_ALL в параметре Flags . Во всех остальных случаях обработчик предшествует этому уведомлению об изменении состояния обработчика, вызвав IDebugEventCallbacks::ChangeEngineState на обратных вызовах событий и передав DEBUG_CES_EXECUTION_STATUS в параметре Flags .

Дополнительные сведения об обработке событий см. в событий мониторинга. Сведения о сеансах отладчика см. в разделе "Модель отладки сеансов и выполнения".

Требования

Требование Ценность
целевая платформа Рабочий стол
Заголовок dbgeng.h (include Dbgeng.h)
  • Last updated on