WSCUnInstallNameSpace, fonction (ws2spi.h)

Article
08/28/2023

La fonction WSCUnInstallNameSpace désinstalle le fournisseur d’espace de noms indiqué.

Syntaxe

INT WSCUnInstallNameSpace(
  [in] LPGUID lpProviderId
);

Paramètres

[in] lpProviderId

Pointeur vers un identificateur global unique (GUID) pour le fournisseur d’espace de noms à désinstaller.

Valeur retournée

Si aucune erreur ne se produit, WSCUnInstallNameSpace retourne NO_ERROR (zéro). Sinon, elle retourne SOCKET_ERROR si la fonction échoue, et vous devez récupérer le code d’erreur approprié à l’aide de la fonction WSAGetLastError .

Code d'erreur	Signification
WSAEFAULT	Le paramètre lpProviderId pointe vers la mémoire qui ne se trouve pas dans une partie valide de l’espace d’adressage utilisateur.
WSAEINVAL	L’identificateur d’espace de noms-fournisseur spécifié n’est pas valide.
WSASYSCALLFAILURE	Un appel système qui ne devrait jamais échouer a échoué.
WSA_NOT_ENOUGH_MEMORY	La mémoire disponible était insuffisante. Cette erreur est retournée lorsque la mémoire est insuffisante pour allouer une nouvelle entrée de catalogue.

Remarques

Les fonctions de configuration de l’espace de noms n’affectent pas les applications qui sont déjà en cours d’exécution. Les fournisseurs d’espace de noms nouvellement installés ne seront pas visibles pour les applications et les modifications apportées à l’état d’activation d’un fournisseur d’espace de noms. Les applications lancées après l’appel à WSCUnInstallNameSpace verront les modifications.

En cas de réussite, WSCUnInstallNameSpace tente d’alerter toutes les applications intéressées qui se sont inscrites pour la notification de la modification en appelant WSAProviderConfigChange.

La fonction WSCUnInstallNameSpace ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si WSCUnInstallNameSpace est appelé par un utilisateur qui n’est pas membre du groupe Administrateurs, l’appel de fonction échoue et WSANO_RECOVERY est retourné dans le paramètre lpErrno .

Pour les ordinateurs s’exécutant sur Windows Vista ou Windows Server 2008, cette fonction peut également échouer en raison du contrôle de compte d’utilisateur (UAC). Si une application qui contient cette fonction est exécutée par un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré, cet appel échoue, sauf si l’application a été marquée dans le fichier manifeste avec un requestedExecutionLevel défini sur requireAdministrator. Si l’application sur Windows Vista ou Windows Server 2008 ne dispose pas de ce fichier manifeste, un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré doit ensuite exécuter l’application dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur d’exécution) pour que cette fonction réussisse.

L’appelant de cette fonction doit supprimer tous les fichiers ou informations de configuration supplémentaires spécifiques au fournisseur de services qui sont nécessaires pour désinstaller complètement le fournisseur de services.

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
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll