更新:2007 年 11 月
获取一个接口指针,该指针指向宿主对具有指定 IID 接口的实现。
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] IUnknown** ppObject
);
参数
riid
[in] 公共语言运行库 (CLR) 正在查询的接口的 IID。ppObject
[out] 一个指向宿主实现的接口的指针,或者如果宿主不支持此接口,则为 Null。
返回值
HRESULT |
说明 |
---|---|
S_OK |
GetHostManager 成功返回。 |
HOST_E_CLRNOTAVAILABLE |
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 查询宿主以确定它是否支持一个或多个下列接口:
如果宿主支持指定的接口,则它会将 ppObject 设置为其对该接口的实现。否则,将 ppObject 设置为 Null。
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.idl
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0