IDebugHost::GetCurrentContext 方法 (dbgmodel.h)
GetCurrentContext 方法會傳回介面,表示調試程式主機的目前狀態。 這的確切意義會保留給主機,但它通常包含會話、進程和位址空間等專案,這些空間在偵錯主機的使用者介面中作用中。 傳回的內容對呼叫端而言大致不透明,但在對偵錯主機的呼叫之間傳遞是很重要的物件。 例如,當呼叫端是讀取記憶體時,請務必知道讀取記憶體的來源進程和地址空間。 該概念會封裝在從這個方法傳回的內容物件概念中。
數據模型中的每個物件和符號都會選擇性地具有內容資訊,例如與它相關聯的內容資訊。 內容通常會從一個對象傳遞至建立為現有物件屬性的新物件。 偵錯主機本身所建立的這類物件可能會導致其他內容資訊內嵌在傳回的物件內 (例如:線程的 Stack 屬性可能會內嵌有關堆疊在內容) 內參考哪些線程的資訊。
語法
HRESULT GetCurrentContext(
IDebugHostContext **context
);
參數
context
這裡會傳回代表主機目前內容的物件。
傳回值
這個方法會傳回 HRESULT,表示成功或失敗。 沒有內容資訊概念的主機可能會在這裡傳回E_NOTIMPL。
備註
程式碼範例
ComPtr<IDebugHost> spHost; /* get the debug host */
ComPtr<IDebugHostContext> spContext;
if (SUCCEEDED(spHost->GetCurrentContext(&spContext)))
{
// spContext now contains an opaque object representing the current UI
// state of the debugger (e.g.: what session/process/thread the debug UI
// is focused on)
}
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |