Metodo IDebugSymbols::SetScope (dbgeng.h)

Articolo
02/25/2024

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 operazione 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 del contesto del thread è la struttura CONTEXT per il processore efficace della destinazione. Il buffer ScopeContext deve essere abbastanza grande per contenere questa struttura. Se ScopeContext è NULL, viene invece usato il contesto del registro corrente.

[in] ScopeContextSize

Specifica le dimensioni del buffer ScopeContext.

Valore restituito

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

Codice restituito	Descrizione
S_OK	L'ambito identificato da InstructionOffset, ScopeFrame e ScopeContext corrisponde all'ambito precedente.
S_FALSE	L'ambito è cambiato.

Commenti

Se viene fornito solo InstructionOffset , l'ambito può essere usato 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 ai registri). Per impostare l'ambito su un frame nello stack corrente, è possibile usare SetScopeFrameByIndex .

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