ICLRGCManager::GetStats-Methode

Artikel
06/05/2023

Ruft einen Satz aktueller Statistiken zum Garbage Collection-System der Common Language Runtime ab.

Syntax

HRESULT GetStats (  
    [in, out] COR_GC_STATS *pStats  
);

Parameter

pStats
[in, out] Eine COR_GC_STATS-Instanz, die die angeforderten Statistiken enthält.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`GetStats` wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Timeout des Aufrufs.
HOST_E_NOT_OWNER	Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL	Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode „E_FAIL“ zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Die CLR berechnet und gibt nur die Statistiken zurück, die durch das Flags-Feld von pStats angegeben sind.

Legen Sie das Feld Flags auf einen oder mehrere Werte der COR_GC_STAT_TYPES-Enumeration fest, um anzugeben, welche Statistiken in der COR_GC_STATS-Struktur festgelegt werden sollen.

Ein Beispiel für die Verwendung lautet wie folgt:

COR_GC_STATS GCStats;  
GCStats.Flags = COR_GC_COUNTS | COR_GC_MEMORYUSAGE;  
pCLRGCManager->GetStats(&GCStats);

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

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

.NET Framework-Versionen: Seit 2.0 verfügbar.

Freigeben über