Метод IDebugSymbols3::SetScope (dbgeng.h)

Статья
08/07/2023

Метод SetScope задает текущий область.

Синтаксис

HRESULT SetScope(
  [in]           ULONG64            InstructionOffset,
  [in, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [in, optional] PVOID              ScopeContext,
  [in]           ULONG              ScopeContextSize
);

Параметры

[in] InstructionOffset

Указывает расположение в виртуальном адресном пространстве процесса для текущей инструкции область. Используется только в том случае, если и ScopeFrame , и ScopeContext имеют значение NULL; в противном случае он игнорируется.

[in, optional] ScopeFrame

Указывает кадр стека область. Сведения об этой структуре см. в разделе DEBUG_STACK_FRAME.

[in, optional] ScopeContext

Указывает контекст потока область. Тип контекста потока — это структура CONTEXT для эффективного процессора целевого объекта. Буфер ScopeContext должен быть достаточно большим, чтобы вместить эту структуру. Если scopeContext имеет значение NULL, вместо него используется текущий контекст регистра .

[in] ScopeContextSize

Указывает размер буфера ScopeContext.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Область, идентифицируемые в ИнструкцияхOffset, ScopeFrame и ScopeContext, совпадают со старыми область.
S_FALSE	Область изменилась.

Чтобы задать предыдущее состояние область, необходимо указать ScopeContext. Это не всегда необходимо (например, если вы хотите получить доступ только к символам, а не к регистрам). Чтобы задать для область кадр в текущем стеке, можно использовать SetScopeFrameByIndex.

Дополнительные сведения об областях см. в разделе Области и группы символов.