Fonction WSCEnableNSProvider (ws2spi.h)
La fonction WSCEnableNSProvider modifie l’état d’un fournisseur d’espace de noms donné. Il est destiné à donner à l’utilisateur final la possibilité de modifier l’état des fournisseurs d’espaces de noms.
Syntaxe
INT WSCEnableNSProvider(
[in] LPGUID lpProviderId,
[in] BOOL fEnable
);
Paramètres
[in] lpProviderId
Pointeur vers un identificateur global unique (GUID) pour le fournisseur d’espaces de noms.
[in] fEnable
Valeur booléenne qui, si true, le fournisseur est défini sur l’état actif. Si la valeur est FALSE, le fournisseur est désactivé et ne sera pas disponible pour les opérations de requête ou l’inscription du service.
Valeur retournée
Si aucune erreur ne se produit, la fonction WSCEnableNSProvider retourne NO_ERROR (zéro). Sinon, il 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 |
|---|---|
| Le paramètre lpProviderId pointe vers la mémoire qui n’est pas dans une partie valide de l’espace d’adressage utilisateur. | |
| L’identificateur de fournisseur d’espaces de noms spécifié n’est pas valide. | |
| Un appel système qui ne doit jamais échouer a échoué. | |
| 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
La fonction WSCEnableNSProvider est destinée à être utilisée pour modifier l’état des fournisseurs d’espaces de noms. Un fournisseur de logiciels indépendant (ISV) ne doit normalement pas désactiver un autre fournisseur d’espaces de noms ISV pour activer son propre fournisseur. Le choix doit être laissé à l’utilisateur.
La fonction WSCEnableNSProvider n’affecte pas les applications qui sont déjà en cours d’exécution. Les fournisseurs d’espaces de noms nouvellement installés ne seront pas visibles par les applications et les modifications apportées à l’état d’activation d’un fournisseur d’espace de noms ne seront pas visibles. Les applications lancées après l’appel à WSCEnableNSProvider verront les modifications.
La fonction WSCEnableNSProvider ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si WSCEnableNSProvider est appelé par un utilisateur qui n’est pas membre du groupe Administrateurs, l’appel de fonction échoue.
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.
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 |