NetWkstaTransportDel, fonction (lmwksta.h)

Article
03/01/2024

[Cette fonction est obsolète. Pour modifier manuellement les paramètres par défaut des protocoles de transport, utilisez la boîte de dialogue Propriétés de connexion à la zone locale dans le dossier Réseau et accès à distance Connections.]

Non pris en charge.

La fonction NetWkstaTransportDel dissocie le protocole de transport du redirecteur. (Le redirecteur est le logiciel sur l’ordinateur client qui génère des demandes de fichiers à l’ordinateur serveur.)

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

Paramètres

[in] servername

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

Cette chaîne doit commencer par \.

[in] transportname

Pointeur vers une chaîne qui spécifie le nom du protocole de transport à déconnecter du redirecteur.

[in] ucond

Spécifie le niveau de force à utiliser lors de la déconnexion du protocole de transport du redirecteur. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
USE_NOFORCE	Échec de la déconnexion si des fichiers ouverts existent sur la connexion.
USE_FORCE	Échec de la déconnexion si des fichiers ouverts existent sur la connexion.
USE_LOTS_OF_FORCE	Fermez tous les fichiers ouverts et supprimez la connexion.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_ACCESS_DENIED	L’utilisateur n’a pas accès aux informations demandées.
ERROR_INVALID_PARAMETER	L’un des paramètres de fonction n’est pas valide.
NERR_UseNotFound	La connexion réseau n’existe pas.

Remarques

Seuls les membres du groupe local Administrateurs peuvent exécuter correctement la fonction NetWkstaTransportDel .

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	lmwksta.h (include Lm.h, Lmwksta.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Partager via