Freigeben über

ICLRGCManager::Collect-Methode

  • Artikel

Erzwingt eine Garbage Collection für die angegebene Generation.

Syntax

HRESULT Collect (  
    [in] LONG Generation  
);

Parameter

Generation
[in] Die Generation, für die die Garbage Collection ausgeführt werden soll. Ein Wert von -1 erzwingt eine Sammlung aller Generationen.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK Collect 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 Collect-Methode erzwingt, dass der Garbage Collector der CLR unabhängig vom aktuellen Zustand eine Garbage Colletion ausführt.

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.

Siehe auch