ICorDebugProcess2::GetReferenceValueFromGCHandle, méthode

Article
08/10/2011

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

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 objet IntPtr et peut être récupérée à partir de GCHandle pour l'objet managé.
pOutValue
[out] Pointeur vers l'adresse d'un objet ICorDebugReferenceValue qui représente 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 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 continue 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.

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