Método ICLRIoCompletionManager::OnComplete

Artigo
08/25/2010

Notifica o common linguagem tempo de execução (CLR) do status de uma solicitação de E/s foi feita usando uma telefonar 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 concluída com êxito.
- HOST_E_INTERRUPTED indica que a telefonar é concluída antes da conclusão.
- E_FAIL indica que ocorreu uma falha desconhecida, irrecuperável, catastrófica.
NumberOfBytesTransferred
[in] O número de bytes transferidos durante o processamento de solicitação de E/s.
pvOverlapped
[in] Um ponteiro para o OVERLAPPED estrutura foi passada para a telefonar para o IHostIoCompletionManager::Bind método.

Valor de retorno

HRESULT	Descrição
S_OK	OnComplete retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Após um método retornar E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem 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.