Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Notifies the host that the currently executing task is about to leave the common language runtime (CLR) and enter unmanaged code.
.gif "Important note") Important |
|---|
A corresponding call to IHostTaskManager::EnterRuntime notifies the host that the currently executing task is reentering managed code. |
HRESULT LeaveRuntime (
[in] SIZE_T target
);
Parameters
- target
[in] The address within the mapped portable executable file of the unmanaged function to be called.
Return Value
HRESULT |
Description |
|---|---|
S_OK |
LeaveRuntime returned successfully. |
HOST_E_CLRNOTAVAILABLE |
The CLR has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully. |
HOST_E_TIMEOUT |
The call timed out. |
HOST_E_NOT_OWNER |
The caller does not own the lock. |
HOST_E_ABANDONED |
An event was canceled while a blocked thread or fiber was waiting on it. |
E_FAIL |
An unknown catastrophic failure occurred. When a method returns E_FAIL, the CLR is no longer usable within the process. Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY |
Not enough memory is available to complete the requested allocation. |
Remarks
Call sequences to and from unmanaged code can be nested. For example, the list below describes a hypothetical situation in which the sequence of calls to LeaveRuntime, IHostTaskManager::ReverseEnterRuntime, IHostTaskManager::ReverseLeaveRuntime, and IHostTaskManager::EnterRuntime allows the host to identify the nested layers.
Action |
Corresponding Method Call |
|---|---|
A managed Visual Basic executable calls an unmanaged function written in C by using platform invoke. |
IHostTaskManager::LeaveRuntime |
The unmanaged C function calls a method in a managed DLL written in C#. |
IHostTaskManager::ReverseEnterRuntime |
The managed C# function calls another unmanaged function written in C, also using platform invoke. |
IHostTaskManager::LeaveRuntime |
The second unmanaged function returns execution to the C# function. |
IHostTaskManager::EnterRuntime |
The C# function returns execution to the first unmanaged function. |
IHostTaskManager::ReverseLeaveRuntime |
The first unmanaged function returns execution to the Visual Basic program. |
IHostTaskManager::EnterRuntime |
Requirements
Platforms: See .NET Framework System Requirements.
Header: MSCorEE.h
Library: Included as a resource in MSCorEE.dll
.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0