ICorDebugHeapValue2::CreateHandle, méthode

Crée un handle du type spécifié pour la valeur de tas représentée par cet objet ICorDebugHeapValue2.

Syntaxe

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

Paramètres

type
[in] Valeur de l’énumération CorDebugHandleType qui spécifie le type de handle à créer.

ppHandle
[out] Pointeur vers l’adresse d’un ICorDebugHandleValue qui représente le nouveau handle de cette valeur de tas.

Notes

Le handle est créé dans le domaine d’application associé à la valeur de tas et devient non valide si le domaine d’application est déchargé.

Plusieurs appels à cette fonction pour la même valeur de tas créent plusieurs handles. Étant donné que les handles affectent les performances du garbage collector, le débogueur doit se limiter à un nombre relativement restreint de handles (environ 256) actifs en même temps.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0