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