CreateDebuggingInterfaceFromVersion Function (.NET Framework)

Creates an ICorDebug object based on the specified version information.

This function is obsolete in the .NET Framework 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.

Syntax

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

Parameters

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

szDebuggeeVersion
[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.

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

Return Value

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

Return code Description
S_OK The method completed successfully.
E_INVALIDARG szDebuggeeVersion or ppCordb is null, or the version string is incorrect.

Remarks

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

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: MSCorEE.dll

.NET Framework Versions: Available since 2.0

See also