NetUseDel, fonction (lmuse.h)

La fonction NetUseDel met fin à une connexion à une ressource partagée.

Vous pouvez également utiliser la fonction WNetCancelConnection2 pour arrêter une connexion réseau.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Paramètres

[in] UncServerName

Nom UNC de l’ordinateur sur lequel exécuter cette fonction. S’il s’agit d’un paramètre NULL, l’ordinateur local est utilisé.

Si le paramètre UncServerName spécifié est un ordinateur distant, l’ordinateur distant doit prendre en charge les appels RPC distants à l’aide du mécanisme hérité du protocole d’accès à distance.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

[in] UseName

Pointeur vers une chaîne qui spécifie le chemin d’accès de la connexion à supprimer.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

[in] ForceLevelFlags

Niveau de force à utiliser pour supprimer la connexion.

Ce paramètre peut être l’une des valeurs suivantes définies dans le fichier d’en-tête lmuseflg.h .

Valeur	Signification
USE_NOFORCE	Échec de la déconnexion si des fichiers ouverts existent sur la connexion.
USE_FORCE	N’échouez pas à 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 est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.

Notes

La fonction NetUseDel s’applique uniquement au client Server Message Block (LAN Manager Workstation). La fonction NetUseDel ne prend pas en charge les partages DFS (Distributed File System) ou d’autres systèmes de fichiers réseau. Pour arrêter une connexion à un partage à l’aide d’un autre fournisseur réseau (WebDAV ou un partage DFS, par exemple), utilisez la fonction WNetCancelConnection2 .

Aucune appartenance à un groupe spécial n’est requise pour appeler la fonction NetUseDel . Cette fonction ne peut pas être exécutée sur un serveur distant, sauf en cas de compatibilité de niveau inférieur.

Spécifications

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	lmuse.h (inclure Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

NetUseAdd

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

Utiliser des fonctions

WNetCancelConnection2