CreateDebuggingInterfaceFromVersion Function for Silverlight

Accepts a common language runtime (CLR) version string that is returned from the CreateVersionStringFromModule function, and returns a corresponding debugger interface (typically, ICorDebug).

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

Parameters

• szDebuggeeVersion
  [in] Version string of the CLR in the target debuggee, which is returned by the CreateVersionStringFromModule function.

• ppCordb
  [out] Pointer to a pointer to a COM object (IUnknown). This object will be cast to an ICorDebug object before it is returned.

Return Value

• S_OK
  ppCordb references a valid object that implements the ICorDebug interface interface.

• E_INVALIDARG
  Either szDebuggeeVersion or ppCordb is null.

• CORDBG_E_DEBUG_COMPONENT_MISSING
  A component that is necessary for CLR debugging cannot be located. This means that either mscordbi.dll or mscordaccore.dll was not found in the same directory as the target CoreCLR.dll.

• CORDBG_E_INCOMPATIBLE_PROTOCOL
  Either mscordbi.dll or mscordaccore.dll is not the same version as the target CoreCLR.dll.

• E_FAIL (or other E_ return codes)
  Unable to return an ICorDebug interface.

Remarks

The interface that is returned provides the facilities for attaching to a CLR in a target process and debugging the managed code that the CLR is running.

Requirements

Platforms: See .NET Framework System Requirements.

Header: dbgshim.h

Library: dbgshim.dll

.NET Framework Versions: 3.5 SP1

See Also

Other Resources

Silverlight Debugging Reference for Windows

Change History

Date	History	Reason
October 2008	Added topic.	Information enhancement.