Dela via


ICorDebugHeapValue2::CreateHandle-metod

Skapar ett handtag av den angivna typen för heapvärdet som representeras av det här ICorDebugHeapValue2-objektet.

Syntax

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

Parametrar

type [i] Ett värde för CorDebugHandleType-uppräkningen som anger vilken typ av handtag som ska skapas.

ppHandle [ut] En pekare till adressen till ett ICorDebugHandleValue-objekt som representerar det nya referensvärdet för det här heapvärdet.

Kommentarer

Handtaget skapas i programdomänen som är associerad med heap-värdet och blir ogiltig om programdomänen tas bort.

Flera anrop till den här funktionen för samma heap-värde skapar flera referenser. Eftersom handtagen påverkar skräpinsamlarens prestanda bör felsökningsprogrammet begränsa sig till ett relativt litet antal handtag (cirka 256) som är aktiva åt gången.

Krav

Plattformar: Se Systemkrav.

Rubrik: CorDebug.idl, CorDebug.h

Bibliotek: CorGuids.lib

.NET Framework-versioner: Tillgänglig sedan 2.0