IHostControl::GetHostManager 方法

取得主機的介面指標，以供實作具指定 IID 的介面。

語法

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

參數

riid
[in] 通用語言執行平台 (CLR) 所查詢之介面的 IID。

ppObject
[out] 主機實作的介面指標，如果主機不支援此介面，則為 null。

傳回值

HRESULT	描述
S_OK	GetHostManager 已成功傳回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未載入處理序，或 CLR 處於無法執行受控程式碼或成功處理呼叫的狀態。
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。

規格需求

平台：請參閱系統需求。

標題： MSCorEE.h

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

.NET Framework版本：自 2.0 起提供

另請參閱

• IHostControl 介面