Edit

Share via

CorBindToCurrentRuntime Function

  • Article

Loads the common language runtime (CLR) into a process by using version information stored in an XML file. The format of the XML file is modeled after the standard application configuration file. For more information about configuration files, see Configuration File Schema.

This function has been deprecated in the .NET Framework 4. See Loading the Common Language Runtime into a Process.

Syntax

HRESULT CorBindToCurrentRuntime (  
    [in]  LPCWSTR   pwszFileName,  
    [in]  REFCLSID  rclsid,  
    [in]  REFIID    riid,  
    [out] LPVOID    *ppv  
);

Parameters

pwszFileName
[in] The name of an application configuration file that specifies the version of the CLR to load. If the file name is not fully qualified, it is assumed to be in the same directory as the executable making the call.

The version of the runtime to be loaded is described by the version attribute in the <requiredRuntime> element of the configuration file.

If no version is specified, or if the <requiredRuntime> element cannot be found, the latest version of the CLR that is installed on the machine is loaded.

rclsid
[in] The CLSID of the coclass that implements either the ICorRuntimeHost or the ICLRRuntimeHost interface. Supported values are CLSID_CorRuntimeHost or CLSID_CLRRuntimeHost.

riid
[in] The IID of the interface you are requesting. Supported values are IID_ICorRuntimeHost or IID_ICLRRuntimeHost.

ppv
[out] The returned interface pointer.

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: MSCorEE.dll

.NET Framework Versions: Available since 1.0

See also