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