Método de ICLRIoCompletionManager::OnComplete

Artigo
08/08/2011

Notifica o common language runtime (CLR) do status de uma solicitação de i/O que foi feito usando uma chamada para o IHostIoCompletionManager::Bind método.

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

Parâmetros

dwErrorCode
[in] Um valor HRESULT que indica o status da operação de vinculação.
- S_OK indica que a operação foi concluída com êxito.
- HOST_E_INTERRUPTED indica que a chamada será finalizada antes da conclusão.
- E_FAIL indica que uma falha catastrófica, irrecuperável, desconhecida ocorreu.
NumberOfBytesTransferred
[in] O número de bytes transferidos durante o processamento da solicitação de i/O.
pvOverlapped
[in] Um ponteiro para o OVERLAPPED estrutura foi passada para a chamada para o IHostIoCompletionManager::Bind método.

Valor de retorno

HRESULT	Descrição
S_OK	OnCompleteretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Depois de um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

Se o host implementa uma abstração de conclusão de e/S, o CLR faz solicitações de i/O através do host usando métodos de IHostIoCompletionManager. O host, em seguida, chama o OnComplete método para notificar o tempo de execução das conseqüências de tais solicitações.