This documentation is archived and is not being maintained.

CreateDebuggingInterfaceFromVersion Function

Creates an ICorDebug object based on the specified version information.

This function is obsolete in the .NET Framework version 4. Instead, to get an interface for the common language runtime (CLR) 2.0, use the ICLRRuntimeInfo::GetInterface method and specify the class identifier CLSID_CLRDebuggingLegacy and the interface identifier IID_ICorDebug. To get an interface for CLR 4 or later, call the CLRCreateInstance function and specify the class identifier CLSID_CLRDebugging and the interface identifier IID_ICLRDebugging.

HRESULT CreateDebuggingInterfaceFromVersion (
    [in]  int      iDebuggerVersion, 
    [in]  LPCWSTR  szDebuggeeVersion, 
    [out] IUnknown **ppCordb


[in] The version of ICorDebug that is expected by the debugger. See the CorDebugInterfaceVersion enumeration for valid values.


[in] The common language runtime version associated with the application or process to be debugged. See the GetVersionFromProcess or GetRequestedRuntimeVersion method for information on retrieving this value.


[out] The location that receives a pointer to the ICorDebug object.

This method returns standard COM error codes as defined in the WinError.h file in addition to the following values.

Return code



The method completed successfully.


szDebuggeeVersion or ppCordb is null, or the version string is incorrect.

The szDebuggeeVersion parameter maps to the corresponding version of MSCorDbi.dll.

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