CorBindToRuntimeByCfg Function

Loads the common language runtime (CLR) into a process by using version information that is read from an XML file.

This function has been deprecated in the .NET Framework version 4.

HRESULT CorBindToRuntimeByCfg (
    [in]  IStream     *pCfgStream,
    [in]  DWORD        reserved,
    [in]  DWORD        startupFlags,
    [in]  REFCLSID     rclsid,
    [in]  REFIID       riid, 
    [out] LPVOID FAR*  ppv
);

Parameters

  • pCfgStream
    [in] A pointer to an IStream object that reads the XML file.

  • reserved
    [in] Reserved for future use. Use 0 (zero) as value.

  • startupFlags
    [in] A value of the STARTUP_FLAGS enumeration that specifies the startup behavior of the CLR.

  • 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 either the ICorRuntimeHost or the ICLRRuntimeHost interface. Supported values are IID_ICorRuntimeHost or IID_ICLRRuntimeHost.

  • ppv
    [out] A pointer to the address of the returned interface.

Remarks

The format of the XML file is modeled after the standard application configuration file. For more information about XML files, see Configuration File Schema for the .NET Framework.

Requirements

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.h

Library: MSCorEE.dll

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

See Also

Reference

CorBindToCurrentRuntime Function

CorBindToRuntime Function

CorBindToRuntimeEx Function

CorBindToRuntimeHost Function

ICorRuntimeHost Interface

Other Resources

.NET Framework 1.1 and 2.0 Hosting Global Static Functions