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

Статья
08/07/2023

Метод SetScopeFrameByIndex задает текущий область область одного из кадров в стеке вызовов.

Синтаксис

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Параметры

[in] Index

Указывает индекс кадра стека, из которого следует задать область. Индекс подсчитывает количество кадров в верхней части стека вызовов. Кадр в верхней части стека, представляющий текущий вызов, имеет нулевой индекс.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

Когда происходит событие и подсистема отладчика разбивается на целевой объект, область присваивается текущий вызов функции (функция, которая выполнялась при возникновении события). Вызов этого метода с параметром Index, равным 1, приведет к изменению текущего область на вызывающий объект текущей функции; если параметр Index имеет значение два, область изменяется на вызывающий объект и т. д.

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