Condividi tramite

Metodo ICorDebugHeapValue2::CreateHandle

  • Articolo

Crea un handle del tipo specificato per il valore dell'heap rappresentato da questo oggetto ICorDebugHeapValue2.

Sintassi

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

Parametri

type [in] Valore dell'enumerazione CorDebugHandleType che specifica il tipo di handle da creare.

ppHandle [out] Puntatore all'indirizzo di un oggetto ICorDebugHandleValue che rappresenta il nuovo handle per questo valore dell'heap.

Osservazioni:

L'handle verrà creato nel dominio applicazione associato al valore dell'heap e diventerà non valido se il dominio dell'applicazione viene scaricato.

Più chiamate a questa funzione per lo stesso valore dell'heap creeranno più handle. Poiché gli handle influiscono sulle prestazioni del Garbage Collector, il debugger deve limitarsi a un numero relativamente ridotto di handle (circa 256) attivi alla volta.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorDebug.idl, CorDebug.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dalla versione 2.0