Metodo ICLRIoCompletionManager::OnComplete

Articolo
08/11/2011

Notifica a Common Language Runtime lo stato di una richiesta I/O effettuata mediante una chiamata al metodo IHostIoCompletionManager::Bind.

HRESULT OnComplete (
    [in] DWORD dwErrorCode,
    [in] DWORD NumberOfBytesTransferred,
    [in] void* pvOverlapped
);

Parametri

dwErrorCode
[in] Valore HRESULT che indica lo stato dell'operazione di associazione.
- S_OK indica che l'operazione è stata completata correttamente.
- HOST_E_INTERRUPTED indica che la chiamata è stata terminata prima del completamento.
- E_FAIL indica che si è verificato un errore sconosciuto e irreversibile.
NumberOfBytesTransferred
[in] Numero di byte trasferiti durante l'elaborazione della richiesta I/O.
pvOverlapped
[in] Puntatore alla struttura OVERLAPPED passata alla chiamata al metodo IHostIoCompletionManager::Bind.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	OnComplete 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 chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Se nell'host è implementata un'astrazione di completamento I/O, CLR effettua le richieste I/O tramite l'host utilizzando i metodi di IHostIoCompletionManager. A questo punto, l'host chiama il metodo OnComplete per notificare a Common Language Runtime il risultato di tali richieste.