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	阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
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 接口