Partager via

WSAProviderCompleteAsyncCall, fonction (ws2spi.h)

  • Article

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
WSA_NOT_ENOUGH_MEMORY
 La mémoire était insuffisante pour effectuer l’opération.
WSAEFAULT
 Une erreur interne s’est produite.
WSAEINVAL
 Un paramètre n’était pas valide. Cette erreur est retournée si le paramètre hAsyncCall était **NULL**.
WSANOTINITIALISED
 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

Voir aussi

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAGetLastError

WSAUnadvertiseProvider