Metodo IDebugSymbols3::SetScope (dbgeng.h)

Articolo
02/06/2025

Il metodo SetScope imposta l'ambito corrente.

Sintassi

HRESULT SetScope(
  [in]           ULONG64            InstructionOffset,
  [in, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [in, optional] PVOID              ScopeContext,
  [in]           ULONG              ScopeContextSize
);

Parametri

[in] InstructionOffset

Specifica il percorso nello spazio indirizzi virtuale del processo per l'istruzione corrente dell'ambito. Questa opzione viene usata solo se scopeframe e ScopeContext sono NULL; in caso contrario, viene ignorato.

[in, optional] ScopeFrame

Specifica il frame dello stack dell'ambito. Per informazioni su questa struttura, vedere DEBUG_STACK_FRAME.

[in, optional] ScopeContext

Specifica il contesto del thread dell'ambito. Il tipo di contesto del thread è la struttura CONTEXT per il processore effettivo della destinazione. Il buffer ScopeContext deve essere sufficientemente grande da contenere questa struttura. Se ScopeContext è NULL, viene invece utilizzato il contesto del registro di corrente.

[in] ScopeContextSize

Specifica le dimensioni del buffer ScopeContext.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	L'ambito identificato da InstructionOffset, ScopeFramee ScopeContext è uguale all'ambito precedente.
S_FALSE	L'ambito è stato modificato.

Osservazioni

Se viene fornito solo instructionOffset, è possibile usare l'ambito per cercare i nomi dei simboli; tuttavia, i valori di questi simboli non saranno disponibili.

Per impostare l'ambito su uno stato precedente, è necessario specificare ScopeContext. Questo non è sempre necessario (ad esempio, se si desidera accedere solo ai simboli e non al registra). Per impostare l'ambito su un frame nello stack corrente, è possibile usare SetScopeFrameByIndex.

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