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

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

Синтаксис

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Параметры

[in] Flags

Задает битовый набор, указывающий характер изменения состояния символа. Могут быть установлены следующие битовые флаги.

Значение	Описание
DEBUG_CSS_LOADS	Подсистема загрузила некоторые символы модуля.
DEBUG_CSS_UNLOADS	Подсистема выгрузила некоторые символы модуля.
DEBUG_CSS_SCOPE	Текущее область символов изменилось.
DEBUG_CSS_PATHS	Изменились пути поиска исполняемого изображения, источника или символов.
DEBUG_CSS_SYMBOL_OPTIONS	Параметры символов изменились.
DEBUG_CSS_TYPE_OPTIONS	Параметры типа изменились.

[in] Argument

Предоставляет дополнительные сведения об изменении состояния символа. Если в параметре Flags задано более одного битового флага, параметр Argument не используется. В противном случае значение Аргумента зависит от значения Flags:

DEBUG_CSS_LOADS

Значение Аргумента — это базовое расположение (в целевом адресном пространстве памяти) изображения модуля, для который подсистема загрузила символы.

DEBUG_CSS_UNLOADS

Значение Аргумента — это базовое расположение (в целевом адресном пространстве памяти) образа модуля, для который подсистема выгружает символы. Если подсистема выгрузила символы для нескольких изображений, значение Аргумента равно нулю.

DEBUG_CSS_SCOPE

Значение Аргумента равно нулю.

DEBUG_CSS_PATHS

Значение Аргумента равно нулю.

DEBUG_CSS_SYMBOL_OPTIONS

Значение Аргумента — это параметры символа.

DEBUG_CSS_TYPE_OPTIONS

Значение Аргумента равно нулю.

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

Возвращаемое значение игнорируется подсистемой, если оно не указывает на ошибку удаленного вызова процедуры; в этом случае клиент, с помощью которого зарегистрирован этот объект IDebugEventCallbacks , отключен.

Комментарии

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)