Aracılığıyla paylaş

ICorProfilerCallback::ObjectReferences Yöntemi

  • Makale

Belirtilen nesne tarafından başvurulmakta olan bellekteki nesneler hakkında profil oluşturucuya bildirir.

Sözdizimi

HRESULT ObjectReferences(  
    [in]  ObjectID objectId,  
    [in]  ClassID  classId,  
    [in]  ULONG    cObjectRefs,  
    [in, size_is(cObjectRefs)] ObjectID objectRefIds[] );

Parametreler

objectId
[in] Nesnelere başvuran nesnenin kimliği.

classId
[in] Belirtilen nesnenin bir örneği olduğu sınıfın kimliği.

cObjectRefs
[in] Belirtilen nesne tarafından başvuruda bulunan nesne sayısı (dizideki objectRefIds öğe sayısı).

objectRefIds
[in] tarafından objectIdbaşvurulmakta olan nesne kimlikleri dizisi.

Açıklamalar

Bir ObjectReferences çöp toplama tamamlandıktan sonra yığında kalan her nesne için yöntemi çağrılır. Profil oluşturucu bu geri çağırmadan bir hata döndürürse, profil oluşturma hizmetleri bir sonraki çöp toplamaya kadar bu geri çağırmayı durduracaktır.

Geri çağırma, ObjectReferences çalışma zamanı için eksiksiz bir nesne başvuru grafiği oluşturmak üzere ICorProfilerCallback::RootReferences geri çağırmasıyla birlikte kullanılabilir. Ortak dil çalışma zamanı (CLR), her nesne başvurusunun yöntemi tarafından ObjectReferences yalnızca bir kez bildirilmesini sağlar.

tarafından ObjectReferences döndürülen nesne kimlikleri geri çağırma sırasında geçerli değildir, çünkü çöp toplama hareketli nesnelerin ortasında olabilir. Bu nedenle, profil oluşturucular bir ObjectReferences çağrı sırasında nesneleri incelemeye çalışmamalıdır. ICorProfilerCallback2::GarbageCollectionFinished çağrıldığında, çöp toplama işlemi tamamlanır ve denetim güvenli bir şekilde yapılabilir.

Null değeri ClassId , kaldırılan bir türe sahip olduğunu gösterir objectId .

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: CorProf.idl, CorProf.h

Kitaplığı: CorGuids.lib

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.