Partager via

ICorDebugProcess2::GetReferenceValueFromGCHandle, méthode

  • Article

Obtient un pointeur de référence vers l’objet managé spécifié qui a un handle de nettoyage de la mémoire.

Syntaxe

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

Paramètres

handle
[in] Pointeur vers un objet managé qui a un handle de nettoyage de la mémoire. Cette valeur est un objet IntPtr qui peut être extrait du GCHandle pour l’objet managé.

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

Notes

Ne confondez pas la valeur de référence retournée avec une valeur de référence de nettoyage de la mémoire.

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.

Notes

La méthode GetReferenceValueFromGCHandle ne valide pas le handle. Par conséquent, la méthode GetReferenceValueFromGCHandle peut potentiellement endommager tant le débogueur que le code débogué si un handle non valide est passé.

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