WSCDeinstallProvider, fonction (ws2spi.h)
La fonction WSCDeinstallProvider supprime le fournisseur de transport spécifié de la base de données de configuration système.
Syntaxe
int WSCDeinstallProvider(
[in] LPGUID lpProviderId,
[out] LPINT lpErrno
);
Paramètres
[in] lpProviderId
Pointeur vers un identificateur global unique (GUID) pour le fournisseur. Cette valeur est stockée dans chaque structure WSAProtocol_Info .
[out] lpErrno
Pointeur vers le code d’erreur en cas d’échec de la fonction.
Valeur retournée
Si aucune erreur ne se produit, WSCDeinstallProvider retourne zéro. Sinon, il retourne SOCKET_ERROR et un code d’erreur spécifique est disponible dans lpErrno.
Code d'erreur | Signification |
---|---|
Le paramètre lpProviderId ne spécifie pas de fournisseur valide. | |
Le paramètre lpErrno ne se trouve pas dans une partie valide de l’espace d’adressage utilisateur. | |
Une erreur non récupérable s’est produite. Cette erreur est retournée dans plusieurs conditions, notamment : l’utilisateur n’a pas les privilèges d’administration requis pour écrire dans le registre Windows Sockets ou un échec s’est produit lors de l’ouverture d’une entrée de catalogue. | |
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
La fonction WSCDeinstallProvider supprime les informations de configuration Windows Sockets 2 courantes pour le fournisseur spécifié. Une fois cette routine terminée, les informations de configuration stockées dans le Registre sont modifiées. Toutefois, toutes les instances Ws2_32.dll actuellement en mémoire ne pourront pas reconnaître cette modification.
En cas de réussite, WSCDeinstallProvider tente d’alerter toutes les applications intéressées qui se sont inscrites pour la notification de la modification en appelant WSAProviderConfigChange.
La fonction WSCDeinstallProvider ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si WSCDeinstallProvider 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 exécutant 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 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 |