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

Artículo
02/26/2024

El método GetScopeSymbolGroup devuelve un grupo de símbolos que contiene los símbolos en el á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 marcas de bits siguientes determinan qué símbolos se incluyen.

Marca	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 de 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 detalles.

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

Comentarios

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.