(dbgeng.h) IDebugSymbols2：：GetScope 方法

GetScope 方法會傳回目前範圍的相關信息。

語法

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

參數

[out, optional] InstructionOffset

接收目前範圍目前指令之進程虛擬位址空間中的位置。

[out, optional] ScopeFrame

接收代表目前範圍堆疊框架 的DEBUG_STACK_FRAME 結構。

[out, optional] ScopeContext

接收目前範圍的 線程內容。 線程內容的型別是目標有效處理器的CONTEXT結構。 緩衝區 ScopeContext 必須夠大，才能保存這個結構。

[in] ScopeContextSize

指定緩衝區 ScopeContext 的大小。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。

傳回碼	描述
S_OK	此方法成功。
E_INVALIDARG	緩衝區 ScopeContext 的大小不夠大，無法保存範圍的內容。

備註

如需範圍的詳細資訊，請參閱 範圍和符號群組。

規格需求

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h、Ntddk.h)

另請參閱

IDebugControl：：GetEffectiveProcessorType

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

ResetScope

SetScope