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 enumeration that specifies the type of handle to be created.
- ppHandle
[out] A pointer to the address of an ICorDebugHandleValue Interface 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: Windows 2000, Windows XP, Windows Server 2003 family
Header: CorDebug.idl
Library: CorGuids.lib
.NET Framework Version: 2.0