Share via


CorBindToRuntimeByCfg Function

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

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: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: MSCorEE.dll

.NET Framework Version: 2.0, 1.1, 1.0

See Also

Concepts

CorBindToCurrentRuntime Function

CorBindToRuntime Function

CorBindToRuntimeEx Function

CorBindToRuntimeHost Function

ICorRuntimeHost Interface

Hosting Global Static Functions