IDebugSymbols3::GetScopeSymbolGroup-Methode (dbgeng.h)

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

Syntax

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *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.

[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.

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.

Anforderungen

Siehe auch

GetScope-

IDebugSymbolGroup

IDebugSymbols

IDebugSymbols2

IDebugSymbols3