ICLRRuntimeHost::SetHostControl 方法

更新：2007 年 11 月

设置公共语言运行库 (CLR) 可用于获取宿主的 IHostControl实现的接口指针。

HRESULT SetHostControl(
    [in] IHostControl* pHostControl
);

参数

HRESULT	说明
S_OK	SetHostControl 成功返回。
HOST_E_CLRNOTAVAILABLE	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 之前（即，在调用 ICLRRuntimeHost::Start 方法或使用任何元数据接口之前）必须调用 SetHostControl。建议在调用 CorBindToCurrentRuntime 函数或 CorBindToRuntimeEx 函数之后立即调用 SetHostControl。