Edit

CreateCordbObject Function

  • Article

Creates a debugger interface (ICorDebug) that provides functionality for instantiating a managed debugging session on a remote process.

Syntax

HRESULT CordbCreateObject (  
       [in]  int         iDebuggerVersion,
       [out] IUnknown**  ppCordb  
);

Parameters

iDebuggerVersion
[in] Debugger version of the target process. This parameter must be CorDebugVersion_2_0 for remote debugging.

ppCordb
[out] Pointer to a pointer to an object that will be cast to an ICorDebug interface and returned.

Return Value

S_OK
The number of CLRs in the process was successfully determined, and the corresponding handle and path arrays were properly filled.

E_INVALIDARG
ppCordb is null, or iDebuggerVersion is not CorDebugVersion_2_0.

E_OUTOFMEMORY
Unable to allocate enough memory for ppCordb

E_FAIL (or other E_ return codes)
Other failures.

Remarks

The ICorDebug interface that is returned in ppCordb is the top-level debugging interface for all managed debugging services.

Requirements

Platforms: See System Requirements.

Header: CoreClrRemoteDebuggingInterfaces.h

Library: mscordbi_macx86.dll

.NET Framework Versions: 3.5 SP1