ICorDebugHeapValue2::CreateHandle Method
Creates a handle of the specified type for the heap value represented by this ICorDebugHeapValue2 object.
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 .NET Framework System Requirements.
Header: CorDebug.idl, CorDebug.h
Library: CorGuids.lib
.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0