ICLRAppDomainResourceMonitor::GetCurrentSurvived-Methode

  • Artikel

Ruft die Anzahl von Bytes ab, die nach der letzten vollständigen, sperrenden Garbage Collection noch vorhanden sind und auf die von der aktuellen Anwendungsdomäne verwiesen wird.

Syntax

HRESULT STDMETHODCALLTYPE GetCurrentSurvived(  
             [in]  DWORD dwAppDomainId,  
             [out] ULONGLONG *pAppDomainBytesSurvived,  
             [out] ULONGLONG *pTotalBytesSurvived);

Parameter

dwAppDomainId
[in] Die ID der angeforderten Anwendungsdomäne.

pAppDomainBytesSurvived
[out] Ein Zeiger auf die Anzahl von Bytes, die nach der letzten Garbage Collection noch vorhanden sind und sich in dieser Anwendungsdomäne befinden. Nach einer vollständigen Garbage Collection ist diese Zahl genau und vollständig. Nach einer kurzlebigen Garbage Collection ist diese Zahl möglicherweise unvollständig. Dieser Parameter kann null sein.

pRuntimeBytesSurvived
[out] Ein Zeiger auf die Gesamtzahl der Bytes, die die letzte Garbage Collection überlebt haben. Nach einer vollständigen Garbage Collection stellt diese Anzahl die Anzahl der Bytes dar, die in verwalteten Heaps gespeichert werden. Nach einer kurzlebigen Auflistung stellt diese Anzahl die Anzahl der Bytes dar, die in kurzlebigen Generationen live gespeichert werden. Dieser Parameter kann null sein.

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler zurück, die Methodenfehler anzeigen.

HRESULT BESCHREIBUNG
S_OK Die Methode wurde erfolgreich abgeschlossen.
COR_E_APPDOMAINUNLOADED Die Anwendungsdomäne wurde entladen oder ist nicht vorhanden.

Bemerkungen

Statistiken werden erst nach einer vollständigen, sperrenden Garbage Collection aktualisiert. d. h. einer, die alle Generationen umfasst und die die Anwendung anhält, während sie erfolgt. Die Überladung der Methode GC.Collect() führt beispielsweise zu einer vollständigen, sperrenden Garbage Collection. Die gleichzeitige Garbage Collection erfolgt im Hintergrund und sperrt die Anwendung nicht.

Die GetCurrentSurvived-Methode ist das nicht verwaltete Äquivalent der verwalteten Eigenschaft AppDomain.MonitoringSurvivedMemorySize.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MetaHost.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit Version 4 verfügbar.

Siehe auch