IDebugSymbols3::GetScopeSymbolGroup-Methode (dbgeng.h)

Artikel
02/26/2024

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, mit dem bestimmt wird, welche Symbole in die Symbolgruppe eingeschlossen werden sollen. Um alle Symbole einzuschließen, legen Sie Flags auf DEBUG_SCOPE_GROUP_ALL fest. Die folgenden Bitflags bestimmen, welche Symbole enthalten sind.

Flag	Beschreibung
DEBUG_SCOPE_GROUP_ARGUMENTS	Schließen 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 Symbolgruppenschnittstellenobjekt erstellt.

[out] Symbols

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

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

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.