WSCDeinstallProvider32, fonction (ws2spi.h)
La fonction WSCDeinstallProvider32 supprime le fournisseur de transport 32 bits spécifié de la base de données de configuration système.
Syntaxe
int WSCDeinstallProvider32(
[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 si la fonction échoue.
Valeur retournée
Si aucune erreur ne se produit, WSCDeinstallProvider32 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 irrécupérable s’est produite. Cette erreur est retournée dans plusieurs conditions, notamment : l’utilisateur n’a pas les privilèges d’administration nécessaires 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 quand la mémoire est insuffisante pour allouer une nouvelle entrée de catalogue. |
Remarques
WSCDeinstallProvider32 est une version strictement 32 bits de WSCDeinstallProvider. Sur un ordinateur 64 bits, tous les appels ne sont pas spécifiquement 32 bits (par exemple, toutes les fonctions qui ne se terminent pas par « 32 ») fonctionnent sur le catalogue 64 bits natif. Les processus qui s’exécutent sur un ordinateur 64 bits doivent utiliser les appels de fonction 32 bits spécifiques pour fonctionner sur un catalogue strictement 32 bits et préserver la compatibilité. Les définitions et la sémantique des appels 32 bits spécifiques sont les mêmes que leurs équivalents natifs.
La fonction WSCDeinstallProvider32 supprime les informations de configuration courantes des Sockets Windows 2 pour le fournisseur 32 bits spécifié. Une fois cette routine terminée, les informations de configuration stockées dans le Registre sont modifiées. Toutefois, les instances Ws2_32.dll actuellement en mémoire ne pourront pas reconnaître cette modification.
En cas de réussite, WSCDeinstallProvider32 tente d’alerter toutes les applications intéressées qui se sont inscrites pour la notification de la modification en appelant WSAProviderConfigChange.
La fonction WSCDeinstallProvider32 ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si WSCDeinstallProvider32 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 paramètre 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 alors exécuter l’application dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur RunAs) pour que cette fonction réussisse.
L’appelant de cette fonction doit supprimer les fichiers supplémentaires ou les informations de configuration 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 Vista, Windows XP Professionnel Édition x64 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 Édition x64 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ws2spi.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |