Fonction WNetDisconnectDialog1W (winnetwk.h)

Article
08/27/2023

La fonction WNetDisconnectDialog1 tente de déconnecter une ressource réseau. Si le réseau sous-jacent retourne ERROR_OPEN_FILES, la fonction invite l’utilisateur à confirmer. En cas d’erreur, la fonction en informe l’utilisateur. La fonction nécessite un OBJET DISCDLGSTRUCT pour spécifier les paramètres de la tentative de déconnexion.

Syntaxe

DWORD WNetDisconnectDialog1W(
  [in] LPDISCDLGSTRUCTW lpConnDlgStruct
);

Paramètres

[in] lpConnDlgStruct

Pointeur vers une structure DISCDLGSTRUCT . La structure spécifie le comportement de la tentative de déconnexion.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR. Si l’utilisateur annule la boîte de dialogue, la valeur de retour est –1.

Si la fonction échoue, la valeur de retour est un code d’erreur système, tel qu’une des valeurs suivantes.

Code de retour	Description
ERROR_CANCELLED	Lorsque le système a invité l’utilisateur à prendre une décision concernant la déconnexion, l’utilisateur a choisi de ne pas se déconnecter.
ERROR_OPEN_FILES	Impossible de se déconnecter, car l’utilisateur utilise activement la connexion.
ERROR_BUSY	Le fournisseur réseau est occupé (éventuellement en initialisation). L’appelant doit réessayer.
ERROR_NO_NETWORK	Le réseau n'est pas disponible.
ERROR_NOT_ENOUGH_MEMORY	La mémoire est insuffisante pour démarrer la boîte de dialogue.
ERROR_EXTENDED_ERROR	Une erreur spécifique au réseau s’est produite. Appelez la fonction WNetGetLastError pour obtenir une description de l’erreur.

Remarques

Notes

L’en-tête winnetwk.h définit WNetDisconnectDialog1 comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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	winnetwk.h
Bibliothèque	Mpr.lib
DLL	Mpr.dll