Partager via

Fonction de rappel LPNSPCLEANUP (ws2spi.h)

  • Article

La fonction NSPCleanup met fin à l’utilisation d’un fournisseur de services d’espace de noms Windows Sockets particulier.

Syntaxe

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

Paramètres

[in] lpProviderId

Pointeur vers le GUID du fournisseur d’espace de noms à terminer.

Valeur retournée

Si aucune erreur ne se produit, NSPCleanup retourne une valeur de NO_ERROR (zéro). Sinon, SOCKET_ERROR (–1) est retourné et le fournisseur 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.
WSAEINVAL Le paramètre lpProviderId ne spécifie pas de fournisseur valide.
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.

Remarques

La fonction NSPCleanup est appelée lorsqu’une application est terminée à l’aide d’un fournisseur de services d’espace de noms Windows Sockets. La fonction NSPCleanup désinscrit un fournisseur d’espace de noms particulier et permet au fournisseur de services de transport de libérer toutes les ressources allouées du fournisseur d’espaces de noms.

La fonction NSPStartup doit être appelée correctement avant d’utiliser des fournisseurs d’espaces de noms. Il est possible d’effectuer plusieurs appels NSPStartup . Toutefois, pour chaque appel NSPStartup , un appel NSPCleanup correspondant doit également être émis. Seul le NSPCleanup 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.

Cette fonction ne doit pas retourner tant que la DLL du fournisseur de services d’espace de noms ne peut pas être déchargée de la mémoire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ws2spi.h

Voir aussi