ICorDebugHeapValue2::CreateHandle Method

Creates a handle of the specified type for the heap value represented by this ICorDebugHeapValue2 object.

Syntax

HRESULT CreateHandle (
    [in] CorDebugHandleType      type,
    [out] ICorDebugHandleValue   **ppHandle
);

Parameters

type [in] A value of the CorDebugHandleType enumeration that specifies the type of handle to be created.

ppHandle [out] A pointer to the address of an ICorDebugHandleValue object that represents the new handle for this heap value.

Remarks

The handle will be created in the application domain that is associated with the heap value, and will become invalid if the application domain gets unloaded.

Multiple calls to this function for the same heap value will create multiple handles. Because handles affect the performance of the garbage collector, the debugger should limit itself to a relatively small number of handles (about 256) that are active at a time.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0