ICorDebugProcess5::EnumerateHeap — Metoda
Pobiera moduł wyliczający dla obiektów na zarządzanym stercie.
Składnia
HRESULT EnumerateHeap(
[out] ICorDebugHeapEnum **ppObjects
);
Parametry
ppObject [out] Wskaźnik do adresu obiektu interfejsu ICorDebugHeapEnum , który jest modułem wyliczania obiektów znajdujących się na zarządzanej stercie.
Uwagi
Przed wywołaniem ICorDebugProcess5::EnumerateHeap metody należy wywołać metodę ICorDebugProcess5::GetGCHeapInformation i zbadać wartość areGCStructuresValid pola zwróconego obiektu COR_HEAPINFO , aby upewnić się, że sterta odzyskiwania pamięci w bieżącym stanie jest wyliczalna. Ponadto ICorDebugProcess5::EnumerateHeap funkcja zwraca wartość , E_FAIL jeśli dołączasz zbyt wcześnie w okresie istnienia procesu, zanim zostanie przydzielona pamięć dla zarządzanego stertu.
Obiekt interfejsu ICorDebugHeapEnum to standardowy moduł wyliczający pochodzący z interfejsu ICorDebugEnum, który umożliwia wyliczanie obiektów COR_HEAPOBJECT. Ta metoda wypełnia obiekt kolekcji ICorDebugHeapEnum COR_HEAPOBJECT wystąpieniami, które zawierają informacje o wszystkich obiektach. Kolekcja może również zawierać COR_HEAPOBJECT wystąpień, które dostarczają informacje o obiektach, które nie są zakorzenione przez żaden obiekt, ale nie zostały jeszcze zebrane przez moduł odśmieceń pamięci.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorDebug.idl, CorDebug.h
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: dostępne od wersji 4.5
