IDebugSymbols3::GetScopeSymbolGroup2-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetScopeSymbolGroup2--Methode gibt eine Symbolgruppe zurück, die die Symbole im Bereich des aktuellen Ziels enthält.

Syntax

HRESULT GetScopeSymbolGroup2(
  [in]           ULONG                Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP2 Update,
  [out]          PDEBUG_SYMBOL_GROUP2 *Symbols
);

Parameter

[in] Flags

Gibt einen Bitsatz an, der verwendet wird, um zu bestimmen, welche Symbole in die Symbolgruppe aufgenommen werden sollen. Um alle Symbole einzuschließen, legen Sie Flags auf DEBUG_SCOPE_GROUP_ALL fest. Die folgenden Bitkennzeichnungen bestimmen, welche Symbole enthalten sind.

Flagge	Beschreibung
DEBUG_SCOPE_GROUP_ARGUMENTS	Fügen Sie die Funktionsargumente für den aktuellen Bereich ein.
DEBUG_SCOPE_GROUP_LOCALS	Schließen Sie die lokalen Variablen für den aktuellen Bereich ein.

[in, optional] Update

Gibt eine zuvor erstellte Symbolgruppe an, die aktualisiert wird, um den aktuellen Bereich widerzuspiegeln. Wenn UpdateNULL-ist, wird ein neues Symbolgruppen-Schnittstellenobjekt erstellt.

[out] Symbols

Empfängt das Symbolgruppenschnittstellenobjekt für den aktuellen Bereich. Ausführliche Informationen zu dieser Schnittstelle finden Sie unter IDebugSymbolGroup-

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Der parameter Update ermöglicht effiziente Updates beim Durchlaufen von Code. Anstatt eine neue Symbolgruppe zu erstellen und aufzufüllen, kann die alte Symbolgruppe aktualisiert werden.

Weitere Informationen zu Bereichen und Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.