Sdílet prostřednictvím


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.