Поделиться через

Метод 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

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

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 (include Dbgeng.h)