ICLRIoCompletionManager::OnComplete (Método)

Artículo
08/10/2011

Notifica a Common Language Runtime (CLR) el estado de una solicitud de E/S que se realizó utilizando una llamada al método IHostIoCompletionManager::Bind.

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

Parámetros

dwErrorCode
[out, optional] Valor que indica el resultado de la operación.
- S_OK indica que la operación se completó correctamente.
- HOST_E_INTERRUPTED indica que la llamada finalizó antes de completarse.
- E_FAIL indica que se produjo un error desconocido irrecuperable.
NumberOfBytesTransferred
[in] Número de bytes transferido durante el procesamiento de la solicitud de E/S.
pvOverlapped
[in] Puntero a la estructura OVERLAPPED pasada a la llamada al método IHostIoCompletionManager::Bind.

Valor devuelto

HRESULT	Descripción
S_OK	OnComplete finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

Si el host implementa una abstracción de finalización de E/S, CLR realiza las solicitudes de E/S a través del host utilizando métodos de IHostIoCompletionManager. A continuación, el host llama al método OnComplete para notificar al motor en tiempo de ejecución sobre el resultado de dichas solicitudes.