共用方式為


ICorDebugHeapValue2::CreateHandle 方法

為此 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 起提供