IHostControl::GetHostManager 方法

  • 项目

更新：2010 年 12 月

获取一个接口指针，该指针指向宿主对具有指定 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 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

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。

即使您将其关闭，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 接口

修订记录

Date

修订记录

原因

2010 年 12 月

阐明了绝不会在主机管理器上调用 Release。

内容 Bug 修复