ICLRIoCompletionManager::OnComplete, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Notifie le Common Language Runtime (CLR) l'état d'une demande d'E/S qui a été faite en utilisant un appel à la méthode IHostIoCompletionManager::Bind.

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

Paramètres

dwErrorCode
[in] Valeur HRESULT qui indique l'état de l'opération de liaison.
- S_OK indique que l'opération s'est achevée avec succès.
- HOST_E_INTERRUPTED indique que l'appel a été interrompu avant d'aboutir.
- E_FAIL indique qu'une défaillance grave, irrécupérable et inconnue s'est produite.
NumberOfBytesTransferred
[in] Nombre d'octets transféré pendant le traitement de la requête d'E/S.
pvOverlapped
[in] Pointeur vers la structure OVERLAPPED qui a été passée à l'appel à la méthode IHostIoCompletionManager::Bind.

Valeur de retour

HRESULT	Description
S_OK	OnComplete a été retourné correctement.
HOST_E_CLRNOTAVAILABLE	Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

Si l'hôte implémente une abstraction de terminaison d'E/S, le Common Language Runtime (CLR) fait des demandes d'E/S à travers l'hôte à l'aide de méthodes de IHostIoCompletionManager. L'hôte appelle ensuite la méthode OnComplete pour avertir le runtime du résultat de ces demandes.