Partilhar via


Método ICLRIoCompletionManager::OnComplete

Notifica o runtime de linguagem comum (CLR) do estado de um pedido de E/S efetuada através de uma chamada para o método IHostIoCompletionManager::Bind .

Sintaxe

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

Parâmetros

dwErrorCode
[in] Um valor HRESULT que indica o estado da operação de enlace.

  • S_OK indica que a operação foi concluída com êxito.

  • HOST_E_INTERRUPTED indica que a chamada terminou antes da conclusão.

  • E_FAIL indica que ocorreu uma falha catastrófica desconhecida, irrecuperável.

NumberOfBytesTransferred
[in] O número de bytes transferidos durante o processamento do pedido de E/S.

pvOverlapped
[in] Um ponteiro para a OVERLAPPED estrutura que foi transmitida à chamada para o IHostIoCompletionManager::Bind método .

Devolver Valor

HRESULT Description
S_OK OnComplete devolvido com êxito.
HOST_E_CLRNOTAVAILABLE O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar o código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Depois de um método devolver E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

Se o anfitrião implementar uma abstração de conclusão de E/S, o CLR efetua pedidos de E/S através do anfitrião através de métodos de IHostIoCompletionManager. Em seguida, o anfitrião chama o OnComplete método para notificar o runtime do resultado desses pedidos.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Ver também