ICorDebugProcess5::EnumerateHeap Yöntemi

Yönetilen yığındaki nesneler için bir numaralandırıcı alır.

Sözdizimi

HRESULT EnumerateHeap(
    [out] ICorDebugHeapEnum **ppObjects
);

Parametreler

ppObject [out] Yönetilen yığında bulunan nesneler için numaralandırıcı olan bir ICorDebugHeapEnum arabirim nesnesinin adresini gösteren işaretçi.

Açıklamalar

yöntemini çağırmadan ICorDebugProcess5::EnumerateHeap önce ICorDebugProcess5::GetGCHeapInformation yöntemini çağırmanız ve döndürülen COR_HEAPINFO nesnesinin alanının değerini areGCStructuresValid inceleyerek geçerli durumundaki çöp toplama yığınının numaralandırılabilir olduğundan emin olmanız gerekir. Buna ek olarak, ICorDebugProcess5::EnumerateHeap yönetilen yığın için bellek ayrılmadan önce işlemin ömründe çok erken eklerseniz, döndürür E_FAIL .

ICorDebugHeapEnum arabirim nesnesi, COR_HEAPOBJECT nesneleri listelemenizi sağlayan ICorDebugEnum arabiriminden türetilen standart bir numaralandırıcıdır. Bu yöntem , ICorDebugHeapEnum koleksiyon nesnesini tüm nesneler hakkında bilgi sağlayan COR_HEAPOBJECT örneklerle doldurur. Koleksiyon, herhangi bir nesne tarafından köklenmemiş ancak henüz çöp toplayıcı tarafından toplanmamış nesneler hakkında bilgi sağlayan COR_HEAPOBJECT örnekleri de içerebilir.

Gereksinimler

Platform: Bkz. .NET tarafından desteklenen işletim sistemleri.

Üstbilgi: CorDebug.idl, CorDebug.h

Kütüphane: CorGuids.lib

.NET sürümleri: .NET Framework 4.5'ten itibaren kullanılabilir

Ayrıca bakınız

• ICorDebugProcess5 Arabirimi