Partager via


ICorDebugHeapValue2::CreateHandle, méthode

Mise à jour : novembre 2007

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

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 objet ICorDebugHandleValue qui représente le nouveau handle pour cette valeur de tas.

Notes

Le handle est dans le domaine d'application qui est associé à la valeur de tas et devient non valide lorsque le domaine d'application est déchargé.

Plusieurs appels à cette fonction pour la même valeur de tas créent plusieurs handles. Comme les handles influent sur les performances du garbage collector, le débogueur doit se limiter à un nombre relativement petit de handles (environ 256) simultanément actifs.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : CorDebug.idl

Bibliothèque : CorGuids.lib

Versions du .NET Framework : 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

ICorDebugHeapValue2