WSCDeinstallProvider32, fonction (ws2spi.h)

Article
08/28/2023

La fonction WSCDeinstallProvider32 supprime le fournisseur de transport 32 bits spécifié de la base de données de configuration système.

Note Cet appel permet à un processus 64 bits de manipuler le catalogue Winsock 32 bits, car WSCDeinstallProvider, sur les ordinateurs 64 bits, manipule uniquement le catalogue de sockets Windows 64 bits natif.

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
WSAEINVAL	Le paramètre lpProviderId ne spécifie pas de fournisseur valide.
WSAEFAULT	Le paramètre lpErrno ne se trouve pas dans une partie valide de l’espace d’adressage utilisateur.
WSANO_RECOVERY	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.
WSA_NOT_ENOUGH_MEMORY	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

Voir aussi

WSAProviderConfigChange

WSCDeinstallProvider

WSCEnumProtocols32

WSCInstallProvider64_32

Partager via