ICLRRuntimeHost::SetHostControl 方法
设置公共语言运行时可用来获取主机实现 IHostControl 接口的接口指针。
语法
HRESULT SetHostControl(
[in] IHostControl* pHostControl
);
参数
pHostControl
[in] 指向主机实现 IHostControl 接口的接口指针。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 SetHostControl 。 |
HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 如果方法返回 E_FAIL,则进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
E_CLR_ALREADY_STARTED | 已初始化 CLR。 |
注解
必须在初始化 CLR 之前调用 SetHostControl
,即在调用 Start 方法 或使用任何元数据接口之前。 建议在调用 CorBindToCurrentRuntime 函数或 CorBindToRuntimeEx 函数后立即调用 SetHostControl
。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用