Compartir a través de


Método IDebugSymbols::GetScopeSymbolGroup (dbgeng.h)

El método GetScopeSymbolGroup devuelve un grupo de símbolos que contiene los símbolos del ámbito del destino actual.

Sintaxis

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *Symbols
);

Parámetros

[in] Flags

Especifica un conjunto de bits usado para determinar qué símbolos se van a incluir en el grupo de símbolos. Para incluir todos los símbolos, establezca Marcas en DEBUG_SCOPE_GROUP_ALL. Las siguientes marcas de bits determinan qué símbolos se incluyen.

Bandera Descripción
DEBUG_SCOPE_GROUP_ARGUMENTS Incluya los argumentos de función para el ámbito actual.
DEBUG_SCOPE_GROUP_LOCALS Incluya las variables locales para el ámbito actual.

[in, optional] Update

Especifica un grupo de símbolos creado anteriormente que se actualizará para reflejar el ámbito actual. Si update es NULL, se crea un nuevo objeto de interfaz de grupo de símbolos.

[out] Symbols

Recibe el objeto de interfaz del grupo de símbolos para el ámbito actual. Para obtener más información sobre esta interfaz, consulte IDebugSymbolGroup

Valor devuelto

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

Código devuelto Descripción
S_OK
El método se realizó correctamente.

Observaciones

El parámetro Update permite actualizaciones eficaces al recorrer el código. En lugar de crear y rellenar un nuevo grupo de símbolos, se puede actualizar el grupo de símbolos antiguo.

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

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

GetScope

IDebugSymbolGroup

IDebugSymbols

IDebugSymbols2

IDebugSymbols3