LPNSPV2LOOKUPSERVICEEND fonction de rappel (ws2spi.h)

Article
03/09/2024

La fonction NSPv2LookupServiceEnd est appelée pour libérer le handle après les appels précédents à NSPv2LookupServiceBegin et NSPv2LookupServiceNextEx.

Syntaxe

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

Paramètres

[in] hLookup

Handle obtenu précédemment par un appel à
NSPv2LookupServiceBegin.

Valeur retournée

La fonction doit retourner NO_ERROR (zéro) si la routine réussit. Elle doit retourner SOCKET_ERROR (autrement dit, 1) si la routine échoue et doit définir le code d’erreur approprié à l’aide de WSASetLastError.

Code d'erreur	Signification
WSA_INVALID_HANDLE	Le handle n’est pas valide.
WSA_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante pour effectuer cette opération.

Remarques

La fonction NSPv2LookupServiceEnd 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 NSPv2LookupServiceEnd ne peut être utilisée que pour les opérations sur NS_EMAIL fournisseurs d’espaces de noms.

Il est possible de recevoir un appel de fonction NSPv2LookupServiceBegin sur un autre thread lors du traitement d’un NSPv2LookupServiceNextEx. Cela indique que le client a annulé la demande et que le fournisseur doit fermer le handle et le retour à partir de l’appel de fonction NSPv2LookupServiceNextEx , en définissant la dernière erreur sur WSA_E_CANCELLED.

Dans Windows Sockets 2, des codes d’erreur en conflit sont définis pour WSAECANCELLED et WSA_E_CANCELLED. Le code d’erreur WSAECANCELLED sera supprimé dans une version ultérieure et seul WSA_E_CANCELLED restera. Les fournisseurs d’espaces de noms doivent utiliser le code d’erreur WSA_E_CANCELLED pour maintenir la compatibilité avec le plus large éventail possible d’applications.

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