Metodo IDebugSymbols::GetScope (dbgeng.h)

Articolo
02/23/2024

Il metodo GetScope restituisce informazioni sull'ambito corrente.

Sintassi

HRESULT GetScope(
  [out, optional] PULONG64           InstructionOffset,
  [out, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [out, optional] PVOID              ScopeContext,
  [in]            ULONG              ScopeContextSize
);

Parametri

[out, optional] InstructionOffset

Riceve la posizione nello spazio indirizzi virtuale del processo dell'istruzione corrente dell'ambito corrente.

[out, optional] ScopeFrame

Riceve la struttura DEBUG_STACK_FRAME che rappresenta il frame dello stack dell'ambito corrente.

[out, optional] ScopeContext

Riceve il contesto del thread dell'ambito corrente. Il tipo di contesto del thread è la struttura CONTEXT per il processore effettivo della destinazione. Il buffer ScopeContext deve essere sufficientemente grande per contenere questa struttura.

[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	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Le dimensioni del buffer ScopeContext non erano sufficienti per contenere il contesto dell'ambito.