LPNSPV2LOOKUPSERVICEEND fonction de rappel (ws2spi.h)
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 |
|---|---|
| Le handle n’est pas valide. | |
| 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 |