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
);
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 .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