IHostTaskManager::LeaveRuntime 方法
通知主机当前正在执行的任务即将对公共语言运行时 (CLR) 执行 leave 操作并输入非托管代码。
重要
对 IHostTaskManager::EnterRuntime 的相应调用会通知主机当前正在执行的任务正在重新输入托管代码。
语法
HRESULT LeaveRuntime (
[in] SIZE_T target
);
参数
target
[in] 要调用的非托管函数的映射可移植可执行文件中的地址。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 LeaveRuntime。 |
| HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
| E_OUTOFMEMORY | 内存不足，无法完成请求分配。 |
备注
可以嵌套指向/来自非托管代码的调用序列。 例如，下表假设指向 LeaveRuntime、IHostTaskManager::ReverseEnterRuntime、IHostTaskManager::ReverseLeaveRuntime 和 IHostTaskManager::EnterRuntime 的调用序列允许主机识别嵌套层。
| 操作 | 相应的方法调用 |
|---|---|
| 托管的 Visual Basic 可执行文件通过使用平台调用调用以 C 编写的非托管函数。 | IHostTaskManager::LeaveRuntime |
| 非托管 C 函数调用以 C# 编写的托管 DLL 中的方法。 | IHostTaskManager::ReverseEnterRuntime |
| 托管 C# 函数也通过使用平台调用调用另一个以 C 编写的非托管函数。 | IHostTaskManager::LeaveRuntime |
| 第二个非托管函数将执行结果返回给 C# 函数。 | IHostTaskManager::EnterRuntime |
| C# 函数将执行结果返回给第一个非托管函数。 | IHostTaskManager::ReverseLeaveRuntime |
| 第一个非托管函数将执行结果返回给 Visual Basic 程序。 | IHostTaskManager::EnterRuntime |
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
