LPNSPV2STARTUP fonction de rappel (ws2spi.h)

Article
08/28/2023

La fonction NSPv2Startup avertit un fournisseur de fournisseurs de services d’espace de noms version 2 (NSPv2) qu’un nouveau processus client doit commencer à utiliser le fournisseur.

Syntaxe

LPNSPV2STARTUP Lpnspv2startup;

INT Lpnspv2startup(
  [in] LPGUID lpProviderId,
  [in] LPVOID *ppvClientSessionArg
)
{...}

Paramètres

[in] lpProviderId

Pointeur vers le GUID du fournisseur d’espace de noms spécifique à notifier.

[in] ppvClientSessionArg

Pointeur vers la session cliente.

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_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante pour effectuer cette opération.
WSAEACCES	La routine appelante ne dispose pas des privilèges suffisants pour initialiser le service.
WSAEINVAL	Un ou plusieurs paramètres n’étaient pas valides ou manquants pour ce fournisseur.
WSAEOPNOTSUPP	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.
WSASERVICE_NOT_FOUND	Le service est inconnu. Le service est introuvable dans l’espace de noms spécifié.

Remarques

La fonction NSPv2Startup 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 NSPv2Startup 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 vers lequel pointe le paramètre ppvClientSessionArg pour stocker des informations sur cette session. La valeur dans le paramètre ppvClientSessionArg sera passée aux appels de fonction NSPv2 suivants dans la même session. L’argument de session client peut avoir la valeur NULL si le fournisseur d’espace de noms n’a pas besoin de ces informations.

La fonction NSPv2Startup est appelée lors de l’initialisation d’une nouvelle session cliente. Les fonctions NSPv2Startup et NSPv2Cleanup doivent être appelées en tant que paires.

La fonction NSPv2Startup doit être appelée correctement avant d’appeler la fonction NSPv2Cleanup . Il est autorisé d’effectuer plusieurs appels NSPv2Startup . Toutefois, pour chaque appel NSPv2Startup , un appel NSPv2Cleanup correspondant doit également être émis. Seul le NSPv2Cleanup final pour le fournisseur de services effectue le nettoyage réel ; les appels précédents décrémentent un nombre de références internes dans le fournisseur de services d’espace de noms.

Les fonctions NSPv2Startup, NSPv2ClientSessionRundown et NSPv2Cleanup sont facultatives, en fonction des exigences du fournisseur NSPv2.

Si la fonction NSPv2Startup 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 NSPv2Startup non implémentée dans la structure NSPV2_ROUTINE doit pointer vers la fonction stub.

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