IHostMemoryManager::RegisterMemoryNotificationCallback-Methode

Registriert einen Zeiger auf eine Rückruffunktion, die der Host aufruft, um die Common Language Runtime (CLR) über die aktuelle Speicherauslastung auf dem Computer zu benachrichtigen.

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

Parameter

pCallback
[in] Ein Schnittstellenzeiger auf eine ICLRMemoryNotificationCallback-Instanz, die von der CLR implementiert wird.

Rückgabewert

HRESULT	Beschreibungen
S_OK	RegisterMemoryNotificationCallback erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die 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. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Da die ICLRMemoryNotificationCallback-Schnittstelle nur eine Methode definiert (ICLRMemoryNotificationCallback::OnMemoryNotification) und da pCallback ein Zeiger auf eine ICLRMemoryNotificationCallback-Instanz ist, die von der CLR bereitgestellt wird, ist die Registrierung für die Rückruffunktion selbst wirksam. Der Host ruft OnMemoryNotification auf, um Speicherdruckbedingungen zu melden, anstatt die normale Win32 CreateMemoryResourceNotification-Funktion zu verwenden. Weitere Informationen finden Sie in der Dokumentation zur Windows-Plattform.