IHostControl::GetHostManager 方法

更新：2010 年 12 月

取得介面指標，指向主應用程式對於具有指定 IID 的介面實作。

HRESULT GetHostManager (
    [in] REFIID riid,
    [out, iid_is(riid)] void** ppObject
);

參數

• riid
  [in] Common Language Runtime (CLR) 正在查詢的介面 IID。

• ppObject
  [out] 主應用程式實作的介面指標，如果主應用程式不支援此介面，則為 null。

傳回值

HRESULT	描述
S_OK	GetHostManager 已成功傳回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。
HOST_E_TIMEOUT	呼叫已逾時。
HOST_E_NOT_OWNER	呼叫端不具備鎖定功能。
HOST_E_ABANDONED	已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。
E_FAIL	發生未知的重大錯誤。 當方法傳回 E_FAIL 時，便無法在處理序內使用 CLR。 對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。
E_INVALIDARG	所要求的 IID 無效。
E_NOINTERFACE	不支援所要求的介面。

備註

CLR 會查詢主應用程式，以判斷它是否支援下列其中一或多個介面：

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

如果主應用程式支援指定的介面，則它會將 ppObject 設定為該介面的實作。 否則，會將 ppObject 設為 null。

CLR 不會呼叫主機管理員的 Release，即使您將其關閉。

需求

**平台：**請參閱 .NET Framework 系統需求。

**標頭：**MSCorEE.h

程式庫：包含做為 MSCorEE.dll 中的資源

**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

請參閱

參考

IHostControl 介面

變更記錄

日期	記錄	原因
2010 年 12 月	釐清永遠不會在主應用程式管理員上呼叫 Release 一事。	內容 Bug 修正。