IHostIoCompletionManager::CreateIoCompletionPort, méthode

Article
05/10/2023

Demande à l’hôte de créer un port d’achèvement d’E/S.

Syntaxe

HRESULT CreateIoCompletionPort (  
    [out] HANDLE *phPort  
);

Paramètres

phPort
[out] Pointeur vers un descripteur vers le port d’achèvement d’E/S nouvellement créé, ou 0 (zéro), si le port n’a pas pu être créé.

Valeur de retour

HRESULT	Description
S_OK	`CreateIoCompletionPort` retourné.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
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. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	La mémoire n’a pas été suffisante pour allouer la ressource demandée.

Notes

Le CLR appelle la méthode CreateIoCompletionPort pour demander à l’hôte de créer un port d’achèvement d’E/S. Il lie les opérations d’E/S à ce port via un appel à la méthode IHostIoCompletionManager::Bind. L’hôte renvoie l’état au CLR en appelant ICLRIoCompletionManager::OnComplete.

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