Método IDebugSymbols3::SetScopeFrameByIndex (dbgeng.h)

Artículo
02/26/2024

El método SetScopeFrameByIndex establece el ámbito actual en el ámbito de uno de los fotogramas de la pila de llamadas.

Sintaxis

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Parámetros

[in] Index

Especifica el índice del marco de pila desde el que se va a establecer el ámbito. El índice cuenta el número de fotogramas de la parte superior de la pila de llamadas. El marco de la parte superior de la pila, que representa la llamada actual, tiene el índice cero.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Cuando se produce un evento y el motor del depurador se divide en un destino, el ámbito se establece en la llamada de función actual (la función que se estaba ejecutando cuando se produjo el evento). Al llamar a este método con Index establecido en uno, se cambiará el ámbito actual al autor de la llamada de la función actual; con Index establecido en dos, el ámbito se cambia al autor de la llamada del autor de la llamada, etc.

Para obtener más información sobre los ámbitos, vea Ámbitos y grupos de símbolos.