Metodo IDebugSymbols::GetScopeSymbolGroup (dbgeng.h)

Articolo
02/23/2024

Il metodo GetScopeSymbolGroup restituisce un gruppo di simboli contenente i simboli nell'ambito della destinazione corrente.

Sintassi

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

Parametri

[in] Flags

Specifica un set di bit usato per determinare quali simboli includere nel gruppo di simboli. Per includere tutti i simboli, impostare Flag su DEBUG_SCOPE_GROUP_ALL. I flag di bit seguenti determinano quali simboli sono inclusi.

Flag	Descrizione
DEBUG_SCOPE_GROUP_ARGUMENTS	Includere gli argomenti della funzione per l'ambito corrente.
DEBUG_SCOPE_GROUP_LOCALS	Includere le variabili locali per l'ambito corrente.

[in, optional] Update

Specifica un gruppo di simboli creato in precedenza che verrà aggiornato per riflettere l'ambito corrente. Se Update è NULL, viene creato un nuovo oggetto dell'interfaccia del gruppo di simboli.

[out] Symbols

Riceve l'oggetto interfaccia del gruppo di simboli per l'ambito corrente. Per informazioni dettagliate su questa interfaccia, vedere IDebugSymbolGroup

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Il parametro Update consente aggiornamenti efficienti durante l'esecuzione del codice. Anziché creare e popolare un nuovo gruppo di simboli, è possibile aggiornare il gruppo di simboli precedente.

Per altre informazioni sugli ambiti e i gruppi di simboli, vedere Ambiti e gruppi di simboli.