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 會查詢主機,以判斷其是否支援下列一或多個介面:
如果主機支援指定的介面,則會將 ppObject
設定為該介面的實作。 否則會將 ppObject
設定為 null。
即使在您關閉主機管理員時,CLR 也不會在主機管理員上呼叫 Release
。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供