Edit

Deprecated CLR Hosting Functions

  • Article

This section describes the unmanaged global static functions that earlier versions of the hosting API used.

With the exception of the infrastructure functions (_Cor* functions), which are used only by the .NET Framework, these functions have been deprecated in the .NET Framework 4.

Activation functions

ClrCreateManagedInstance Function
Deprecated. Creates an instance of the specified managed type.

CoInitializeCor Function
Obsolete. To initialize the common language runtime (CLR), use either CorBindToRuntimeEx or CorBindToCurrentRuntime.

CoInitializeEE Function
Deprecated. Ensures that the CLR execution engine is loaded into a process. Use the ICLRRuntimeHost::Start method instead.

CorBindToCurrentRuntime Function
Deprecated. Loads the common language runtime (CLR) into a process by using version information stored in an XML file.

CorBindToRuntime Function
Deprecated. Enables unmanaged hosts to load the CLR into a process.

CorBindToRuntimeByCfg Function
Deprecated. Loads the CLR into a process by using version information that is read from an XML file.

CorBindToRuntimeEx Function
Deprecated. Enables unmanaged hosts to load the CLR into a process, and allows you to set flags to specify the behavior of the CLR.

CorBindToRuntimeHost Function
Deprecated. Enables hosts to load a specified version of the CLR into a process.

GetCORRequiredVersion Function
Deprecated. Gets the required CLR version number.

GetCORSystemDirectory Function
Deprecated. Returns the installation directory of the CLR that is loaded into the process.

GetRealProcAddress Function
Deprecated. Gets the address of the specified function that is exported from the latest installed version of the CLR.

GetRequestedRuntimeInfo Function
Deprecated. Gets version and directory information about the CLR requested by an application.

CLR version functions

The functions in this section return a CLR version; they do not activate the CLR.

GetCORVersion Function
Deprecated. Returns the version number of the CLR that is running in the current process.

GetFileVersion Function
Deprecated. Gets the CLR version information of the specified file, using the specified buffer.

GetRequestedRuntimeVersion Function
Deprecated. Gets the version number of the CLR requested by the specified application. If that version is not installed, gets the most recent version that is installed before the requested version.

GetRequestedRuntimeVersionForCLSID Function
Deprecated. Gets the appropriate CLR version information for the class with the specified CLSID.

GetVersionFromProcess Function
Deprecated. Gets the version number of the CLR that is associated with the specified process handle.

LockClrVersion Function
Deprecated. Allows the host to determine which version of the CLR will be used within the process before explicitly initializing the CLR.

Hosting functions

CallFunctionShim Function
Deprecated. Makes a call to the function that has the specified name and parameters in the specified library.

CoEEShutDownCOM Function
Deprecated. Unloads a COM assembly from the process.

CorExitProcess Function
Deprecated. Shuts down the current unmanaged process.

CorLaunchApplication Function
Deprecated. Starts the application at the specified network path, using the specified manifests and other application data.

CorMarkThreadInThreadPool Function
Deprecated. Marks the currently executing thread-pool thread for the execution of managed code. Starting with .NET Framework version 2.0, this function has no effect. It is not required, and can be removed from your code.

CoUninitializeCor Function
Obsolete. The CLR cannot be unloaded from a process.

CoUninitializeEE Function
Obsolete.

CreateDebuggingInterfaceFromVersion Function
Deprecated. Creates an ICorDebug object based on the specified version information.

CreateICeeFileGen Function
Deprecated. Creates an ICeeFileGen object.

DestroyICeeFileGen Function
Deprecated. Destroys an ICeeFileGen object.

FExecuteInAppDomainCallback Function Pointer
Deprecated. Points to a function that the CLR calls to execute managed code.

FLockClrVersionCallback Function Pointer
Deprecated. Points to a function that the CLR calls to notify the host that initialization has either started or completed.

GetCLRIdentityManager Function
Deprecated. Gets a pointer to an interface that allows the CLR to manage identities.

LoadLibraryShim Function
Deprecated. Loads a specified version of a .NET Framework DLL.

LoadStringRC Function
Deprecated. Translates an HRESULT value into an error message by using the default culture of the current thread.

LoadStringRCEx Function
Deprecated. Translates an HRESULT value to an appropriate error message for the specified culture.

LPOVERLAPPED_COMPLETION_ROUTINE Function Pointer
Deprecated. Points to a function that notifies the host when an overlapped (that is, asynchronous) I/O to a device has completed.

LPTHREAD_START_ROUTINE Function Pointer
Deprecated. Points to a function that notifies the host that a thread has started to execute.

RunDll32ShimW Function
Deprecated. Executes the specified command.

WAITORTIMERCALLBACK Function Pointer
Deprecated. Points to a function that notifies the host that a wait handle has either been signaled or timed out.

Infrastructure functions

The functions in this section are for use by the .NET Framework only.

_CorDllMain Function
Initializes the CLR, locates the managed entry point in the DLL assembly's CLR header, and begins execution.

_CorExeMain Function
Initializes the CLR, locates the managed entry point in the executable assembly's CLR header, and begins execution.

_CorExeMain2 Function
Executes the entry point in the specified memory-mapped code. This function is called by the operating system loader.

_CorImageUnloading Function
Notifies the loader when the managed module images are unloaded.

_CorValidateImage Function
Validates managed module images, and notifies the operating system loader after they have been loaded.

See also