Metodo IHostMemoryManager::RegisterMemoryNotificationCallback

Articolo
08/11/2011

Registra un puntatore a una funzione di callback chiamata dall'host per notificare a Common Language Runtime il carico di memoria corrente sul computer.

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

Parametri

pCallback
[in] Puntatore a interfaccia a un'istanza di ICLRMemoryNotificationCallback implementata da Common Language Runtime.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	RegisterMemoryNotificationCallback ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Poiché l'interfaccia ICLRMemoryNotificationCallback definisce solamente un metodo (ICLRMemoryNotificationCallback::OnMemoryNotification) e poiché l'oggetto pCallback è un puntatore a un'istanza di ICLRMemoryNotificationCallback fornita da Common Language Runtime, viene registrata la funzione di callback stessa. Per segnalare lo stato di pressione della memoria, l'host chiama il metodo OnMemoryNotification, anziché la funzione Win32 standard CreateMemoryResourceNotification. Per ulteriori informazioni, vedere la documentazione relativa alla piattaforma Windows.