CreateDebuggingInterfaceFromVersion Function

  • Article

Creates an ICorDebug object based on the specified version information.

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 argument maps to the corresponding version of MSCorDbi.dll.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: MSCorEE.dll

.NET Framework Version: 2.0

See Also

Concepts

Hosting Global Static Functions