Metodo IDebugSymbols3::GetScopeSymbolGroup (dbgeng.h)

Articolo
02/06/2025

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

Bandiera	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 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

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

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