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

Remarques

Le handle est créé dans le domaine d’application associé à la valeur du 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 faible de handles (environ 256) actifs à la fois.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

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

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 2.0