WSAProviderCompleteAsyncCall, fonction (ws2spi.h)
La fonction WSAProviderCompleteAsyncCall avertit un client lorsqu’un appel asynchrone à un fournisseur d’espace de noms version 2 est terminé.
Syntaxe
INT WSAAPI WSAProviderCompleteAsyncCall(
HANDLE hAsyncCall,
INT iRetCode
);
Paramètres
hAsyncCall
Handle passé à l’appel asynchrone en cours d’exécution. Ce handle est passé par le client au fournisseur d’espace de noms version 2 dans l’appel de fonction asynchrone.
iRetCode
Code de retour pour l’appel asynchrone au fournisseur d’espace de noms version 2.
Valeur retournée
Si aucune erreur ne se produit, WSAProviderCompleteAsyncCall retourne zéro.
Si la fonction échoue, la valeur de retour est SOCKET_ERROR. Pour obtenir des informations d’erreur étendues, appelez WSAGetLastError, qui retourne l’une des valeurs d’erreur étendues suivantes.
| Code d'erreur | Signification |
|---|---|
| La mémoire était insuffisante pour effectuer l’opération. | |
| Une erreur interne s’est produite. | |
| Un paramètre n’était pas valide. Cette erreur est retournée si le paramètre hAsyncCall était **NULL**. | |
| Le Ws2_32.dlln’a pas été initialisé. L’application doit d’abord appeler WSAStartup avant d’appeler les fonctions Windows Sockets. |
Remarques
La fonction WSAProviderCompleteAsyncCall est utilisée dans le cadre de l’architecture du fournisseur de services d’espace de noms version 2 (NSPv2) disponible sur Windows Vista et versions ultérieures.
Sur Windows Vista et Windows Server 2008, la fonction WSAUnadvertiseProvider ne peut être utilisée que pour les opérations sur NS_EMAIL fournisseurs d’espaces de noms. Les appels asynchrones aux fournisseurs NSPv2 ne sont pas pris en charge sur Windows Vista et Windows Server 2008. Par conséquent, WSAProviderCompleteAsyncCall n’est pas applicable actuellement. Cette fonction est prévue pour être utilisée dans les versions ultérieures de Windows lorsque les appels asynchrones aux fournisseurs d’espaces de noms sont pris en charge.
En général, les fournisseurs NSPv2 sont implémentés dans des processus autres que les applications appelantes. Les fournisseurs NSPv2 ne sont pas activés en raison de l’activité du client. Chaque application d’hébergement de fournisseur décide quand rendre un fournisseur spécifique disponible ou indisponible en appelant les fonctions WSAAdvertiseProvider et WSAUnadvertiseProvider . L’activité du client entraîne uniquement des tentatives de contact avec le fournisseur, lorsqu’il est disponible (lorsque le fournisseur d’espace de noms est publié).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ws2spi.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |