Partager via


ICorDebugProcess2 ::GetReferenceValueFromGCHandle, méthode

Obtient un pointeur de référence vers l’objet managé spécifié qui a un handle de garbage collection.

Syntaxe

HRESULT GetReferenceValueFromGCHandle (
    [in]  UINT_PTR                 handle,
    [out] ICorDebugReferenceValue  **pOutValue
);

Paramètres

handle [in] Pointeur vers un objet managé qui a un handle de garbage collection. Cette valeur est un IntPtr objet et peut être récupérée à partir de l’objet GCHandle managé.

pOutValue [out] Pointeur vers l’adresse d’un objet ICorDebugReferenceValue qui représente une référence à l’objet managé spécifié.

Remarques

Ne confondez pas la valeur de référence retournée par une valeur de référence de garbage collection.

La référence retournée se comporte comme une référence normale. Elle est désactivée lorsque l’exécution du code se poursuit après un point d’arrêt. La durée de vie de l’objet cible n’est pas affectée par la durée de vie de la valeur de référence.

Note

La GetReferenceValueFromGCHandle méthode ne valide pas le handle. Par conséquent, la GetReferenceValueFromGCHandle méthode peut potentiellement endommager le débogueur et le code en cours de débogage si un handle non valide est passé.

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