ICLRControl::GetCLRManager 方法
获取一个接口指针,该指针指向可由宿主用于配置公共语言运行时 (CLR) 的任何管理器类型的实例。
HRESULT GetCLRManager (
[in] REFIID riid,
[out] void **ppObject
);
参数
riid
[in] 要返回的管理器类型的 IID。 以下为支持的 IID 值。IID_ICLRDebugManager:指定 ppObject 将属于 ICLRDebugManager 类型。
IID_ICLRHostProtectionManager:指定 ppObject 属于 ICLRHostProtectionManager 类型。
IID_ICLRGCManager:指定 ppObject 将属于 ICLRGCManager 类型。
IID_ICLRHostProtectionManager:指定 ppObject 将属于 ICLRHostProtectionManager 类型。
IID_ICLROnEventManager:指定 ppObject 将属于 ICLROnEventManager 类型。
IID_ICLRPolicyManager:指定 ppObject 将属于 ICLRPolicyManager 类型。
IID_ICLRGCManager:指定 ppObject 将属于 ICLRGCManager 类型。
ppObject
[out] 指向所请求管理器的接口指针;如果请求的管理器类型无效,则为 Null。
返回值
HRESULT |
说明 |
---|---|
S_OK |
该方法已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。 |
HOST_E_TIMEOUT |
调用超时。 |
HOST_E_NOT_OWNER |
调用方不拥有锁。 |
HOST_E_ABANDONED |
事件在被阻止的线程或纤程正在等待它时被取消。 |
E_FAIL |
发生了未知的灾难性故障。 在某方法返回 E_FAIL 后,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。 |
E_NOINTERFACE |
接口类型不受支持。 |
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0