ICorProfilerCallback::ObjectReferences, méthode
Informe le profileur à propos des objets en mémoire qui sont référencés par l'objet spécifié.
HRESULT ObjectReferences(
[in] ObjectID objectId,
[in] ClassID classId,
[in] ULONG cObjectRefs,
[in, size_is(cObjectRefs)] ObjectID objectRefIds[] );
Paramètres
objectId
[in] ID de l'objet qui référence des objets.classId
[in] ID de la classe dont l'objet spécifié est une instance.cObjectRefs
[in] Nombre d'objets référencés par l'objet spécifié (à savoir le nombre d'éléments figurant dans le tableau objectRefIds).objectRefIds
[in] Tableau des ID des objets qui sont référencés par objectId.
Notes
La méthode ObjectReferences est appelée pour chaque objet qui reste dans le tas après l'exécution d'un garbage collection. Si le profileur retourne une erreur à partir de ce rappel, les services de profilage cessent d'appeler ce rappel jusqu'au garbage collection suivant.
Le rappel ObjectReferences peut être associé au rappel ICorProfilerCallback::RootReferences pour créer un graphique de référence d'objet complet pour le runtime. Le Common Language Runtime (CLR) garantit que chaque référence d'objet est rapportée une seule fois par la méthode ObjectReferences.
Les ID d'objet retournés par ObjectReferences ne sont pas valides pendant le rappel en tant que tel, car le garbage collection peut être en train de déplacer des objets. Par conséquent, les profileurs ne doivent pas essayer d'inspecter les objets pendant un appel ObjectReferences. Lorsqu'ICorProfilerCallback2::GarbageCollectionFinished est appelé, le garbage collection est terminé et l'inspection peut être effectuée sans risque.
Un paramètre null ClassId indique que objectId a un type qui se décharge.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : CorProf.idl, CorProf.h
Bibliothèque : CorGuids.lib
Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0