Hosting API CompatibilityTable
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
The following table describes the interactions that may occur between the hosting interfaces in different versions of the .NET Framework. References to CorBindTo* functions include the following deprecated hosting global static functions:
NET Framework 4 hosting |
.NET Framework 2.0 hosting |
Interaction |
|---|---|---|
ICLRMetaHost::GetRuntime method |
|
ICLRMetaHost::GetRuntime supersedes the CorBindToRuntimeEx function used with STARTUP_LOADER_SAFEMODE. A host may call one of the CorBindTo* functions to instantiate a particular version of the common language runtime (CLR). If the host then calls ICLRMetaHost::GetRuntime, depending on the hosting policy in place, GetRuntime returns an ICLRRuntimeInfo pointer to either a new runtime instance, or to the runtime that is already loaded in memory. |
|
For compatibility with earlier versions of the hosting API, ICLRMetaHost::EnumerateLoadedRuntimes interacts with CorBindTo* functions and the two interfaces in the following way: Whenever a host application calls a hosting API from a previous version to load a runtime, ICLRMetaHost::EnumerateLoadedRuntimes is able to list that runtime. Also, GetVersionFromProcess Function lists all runtime versions loaded by ICLRMetaHost::GetRuntime, ICLRMetaHost::EnumerateInstalledRuntimes, ICLRMetaHost::EnumerateLoadedRuntimes, or ICLRRuntimeHost3::StartWithFlags Method. |
|
ICLRMetaHost::RequestRuntimeLoadedNotification Method Method |
LockClrVersion function |
The callback function that is set by ICLRMetaHost::SetRuntimeLoadedCallback is triggered by a call to any CorBindTo* function. LockClrVersion is triggered by calls to the .NET Framework 4 Beta 1 hosting API only when the runtime that is being loaded is also loadable by the earlier hosting API. |
GetRequestedRuntimeInfo function GetRequestedRuntimeVersion function |
The function and method return the same value. |
|
GetCORSystemDirectory function |
The function and method return the same value. |
|
ICLRRuntimeInfo::IsLoaded method |
|
ICLRRuntimeInfo::IsLoaded is consistent with the CorBindTo* functions, and the two interfaces. If a host calls the earlier hosting API to instantiate a runtime, a later call to ICLRRuntimeInfo::IsLoaded, relative to the instantiated runtime, returns true. Otherwise, it returns false. |
ICLRRuntimeInfo::LoadLibrary method |
LoadLibraryShim function |
The handles returned by LoadLibraryShim Function are fully compatible with the in-process side-by-side hosting interfaces. |
ICLRRuntimeHost3::IsStarted method |
ICorRuntimeHost::Start method ICorRuntimeHost::Stop method ICLRRuntimeHost::Start method ICLRRuntimeHost::Stop method |
ICLRRuntimeHost3::IsStarted returns valid status for runtime versions that are started and stopped by the earlier hosting API methods. |
See Also
Concepts
In-Process Side-by-Side Runtime Host Activation