為此 ICorDebugHeapValue2 物件所代表的堆積值建立指定類型的控制碼。
語法
HRESULT CreateHandle (
[in] CorDebugHandleType type,
[out] ICorDebugHandleValue **ppHandle
);
參數
type [在]CorDebugHandleType 列舉的值,可指定要建立的句柄類型。
ppHandle [出]ICorDebugHandleValue 物件位址的指標,代表此堆積值的新控制碼。
備註
控制碼將在與資料堆值相關聯的應用程式網域中建立,如果卸載應用程式網域,則會變成無效。
針對相同的堆值多次呼叫此函式會建立多個控制碼。 因為控制碼會影響記憶體回收器的效能,所以偵錯工具應該將自己限制為一次作用中的控制碼數目相對較少 (大約 256 個)。
需求
平台: 請參閱 .NET 支援的作業系統。
標題: CorDebug.idl、CorDebug.h
圖書館: CorGuids.lib
.NET 版本: 自 .NET Framework 2.0 起提供