ICLRIoCompletionManager::OnComplete, méthode

Article
05/10/2023

Notifie le common language runtime (CLR) de l’état d’une requête d’E/S effectuée via un appel à la méthode IHostIoCompletionManager::Bind.

Syntaxe

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 a abouti.
HOST_E_INTERRUPTED indique que l’appel s’est terminé avant la fin.
E_FAIL indique qu’une défaillance irrécupérable inconnue et irrécupérable s’est produite.

NumberOfBytesTransferred
[in] Nombre d’octets transférés 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` retourné.
HOST_E_CLRNOTAVAILABLE	Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

Si l’hôte implémente une abstraction d’achèvement d’E/S, le CLR effectue des requêtes d’E/S via l’hôte à l’aide de méthodes de IHostIoCompletionManager. L’hôte appelle ensuite la méthode OnComplete pour notifier au runtime le résultat de ces requêtes.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via