Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Registriert einen Zeiger auf eine Rückruffunktion, die der Host aufruft, um die Common Language Runtime (CLR) über die aktuelle Speicherauslastung des Computers zu informieren.
Syntax
HRESULT RegisterMemoryNotificationCallback (
[in] ICLRMemoryNotificationCallback* pCallback
);
Parameter
pCallback
[in] Ein Schnittstellenzeiger auf eine ICLRMemoryNotificationCallback-Instanz, die von der CLR implementiert wird.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK |
RegisterMemoryNotificationCallback wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die 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
Da die ICLRMemoryNotificationCallback-Schnittstelle nur eine Methode definiert (ICLRMemoryNotificationCallback::OnMemoryNotification), und weil es sich bei pCallback um einen Zeiger auf eine von der CLR bereitgestellte ICLRMemoryNotificationCallback-Instanz handelt, gilt die Registrierung effektiv für die Rückruffunktion selbst. Der Host ruft OnMemoryNotification zur Meldung von Speicherauslastungsbedingungen auf, anstatt die Win32-Standardfunktion CreateMemoryResourceNotification zu verwenden. Weitere Informationen finden Sie in der Dokumentation zur Windows-Plattform.
Hinweis
OnMemoryNotification-Aufrufe werden nie blockiert. Sie werden immer sofort zurückgegeben.
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
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
