Freigeben über


ICLRGCManager::GetStats-Methode

Aktualisiert: November 2007

Ruft aktuelle Statistiken über das Garbage Collection-System der Common Language Runtime ab.

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

Parameter

  • pStats
    [in, out] Eine COR_GC_STATS-Instanz, die die angeforderte Statistik 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 befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.

HOST_E_TIMEOUT

Der Aufruf hat das Zeitlimit überschritten.

HOST_E_NOT_OWNER

Der Aufrufer ist nicht Besitzer der Sperre.

HOST_E_ABANDONED

Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.

E_FAIL

Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Die CLR berechnet nur die Statistiken und gibt nur die Statistiken zurück, die vom Flags-Feld von pStats angegeben werden.

Legen Sie das Flags-Feld 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.

Im Folgenden finden Sie ein Verwendungsbeispiel:

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

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.idl

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Konzepte

Automatische Speicherverwaltung

Referenz

COR_GC_STATS

COR_GC_STAT_TYPES-Enumeration

ICLRControl

ICLRGCManager

Weitere Ressourcen

Garbage Collection

Bereitstellen der Common Language Runtime