fonction de rappel LPNSPV2CLIENTSESSIONRUNDOWN (ws2spi.h)
La fonction NSPv2ClientSessionRundown avertit un fournisseur de services d’espace de noms version 2 (NSPv2) que la session cliente se termine.
Syntaxe
LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;
void Lpnspv2clientsessionrundown(
[in] LPGUID lpProviderId,
[in] LPVOID pvClientSessionArg
)
{...}
Paramètres
[in] lpProviderId
Pointeur vers le GUID du fournisseur d’espace de noms spécifique à notifier.
[in] pvClientSessionArg
Pointeur vers la session cliente qui se termine.
Valeur retournée
La fonction doit retourner NO_ERROR (zéro) si la routine réussit. Il doit retourner SOCKET_ERROR (c’est-à-dire 1) si la routine échoue et il doit définir le code d’erreur approprié à l’aide de WSASetLastError.
| Code d'erreur | Signification |
|---|---|
| La mémoire disponible est insuffisante pour effectuer cette opération. | |
| La routine appelante ne dispose pas des privilèges suffisants pour installer le service. | |
| Un ou plusieurs paramètres n’étaient pas valides ou manquants pour ce fournisseur. | |
| L'opération n'est pas prise en charge. Cette erreur est retournée si le fournisseur d’espaces de noms n’implémente pas cette fonction. Cette erreur peut également être retournée si le dwControlCode spécifié est une commande non reconnue. | |
| Le service est inconnu. Le service est introuvable dans l’espace de noms spécifié. |
Remarques
La fonction NSPv2ClientSessionRundown 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 NSPv2ClientSessionRundown ne peut être utilisée que pour les opérations sur NS_EMAIL fournisseurs d’espaces de noms.
La fonction NSPv2Startup est appelée chaque fois qu’un nouveau processus client commence à utiliser le fournisseur d’espaces de noms. Les fournisseurs peuvent utiliser l’argument de session client pointé vers le paramètre ppvClientSessionArg pour stocker des informations sur cette session. Si une valeur a été spécifiée pour l’argument de session cliente dans l’appel à la fonction NSPv2Startup , ce même argument de session client est passé dans le paramètre pvClientSessionArg à la fonction NSPv2ClientSessionRundown .
Les fonctions NSPv2Startup, NSPv2ClientSessionRundown et NSPv2Cleanup sont facultatives, en fonction des exigences du fournisseur NSPv2.
Si la fonction NSPv2ClientSessionRundown n’est pas implémentée, les appels à cette fonction doivent être interceptés par une fonction stub qui retourne WSAEOPNOTSUPP. Le pointeur de la fonction NSPv2 vers la fonction NSPv2ClientSessionRundown non implémentée dans la structure NSPV2_ROUTINE doit pointer vers la fonction stub.
Spécifications
| 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 |