ICorProfilerCallback::RootReferences metódus

Értesíti a profilkészítőt a szemétgyűjtés utáni gyökérhivatkozásokkal kapcsolatos információkkal.

Szintaxis

HRESULT RootReferences(  
    [in] ULONG    cRootRefs,  
    [in, size_is(cRootRefs)] ObjectID rootRefIds[] );  

Paraméterek

cRootRefs
[in] A tömbben lévő rootRefIds hivatkozások száma.

rootRefIds
[in] Objektumazonosítók tömbje, amely statikus objektumra vagy a verem egy objektumára hivatkozik.

Megjegyzések

A rendszer az ICorProfilerCallback2::RootReferences2 parancsot is RootReferences meghívja a profilkészítő értesítéséhez. A profilkészítők általában az egyiket vagy a másikat implementálják, de mindkettőt nem, mert a átadott RootReferences2 információk a () fájlban RootReferencesátadott adatok szuperhalmaza.

rootRefIds A tömb tartalmazhat null értékű objektumot. A veremen deklarált összes objektumhivatkozást például a szemétgyűjtő gyökérként kezeli, és mindig jelentést küld.

Az által RootReferences visszaadott objektumazonosítók nem érvényesek a visszahívás során, mert előfordulhat, hogy a szemétgyűjtés az objektumok régi címekről új címekre való áthelyezésének közepén van. Ezért a profilkészítők nem kísérelhet meg objektumokat megvizsgálni hívás RootReferences közben. Az ICorProfilerCallback2::GarbageCollectionFinished hívásakor az összes objektum át lett helyezve az új helyükre, és biztonságosan ellenőrizhető.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: CorProf.idl, CorProf.h

Könyvtár: CorGuids.lib

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még

• ICorProfilerCallback felület