Fonction WNetDisconnectDialog (winnetwk.h)

Article
08/27/2023

La fonction WNetDisconnectDialog démarre une boîte de dialogue de navigation générale pour se déconnecter des ressources réseau. La fonction nécessite un handle pour la fenêtre propriétaire pour la boîte de dialogue.

Syntaxe

DWORD WNetDisconnectDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Paramètres

[in] hwnd

Gérer vers la fenêtre propriétaire de la boîte de dialogue.

[in] dwType

Type de ressource à déconnecter. Ce paramètre peut avoir la valeur suivante.

Valeur	Signification
RESOURCETYPE_DISK	Se déconnecte des ressources de disque.

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_EXTENDED_ERROR	Une erreur spécifique au réseau s’est produite. Pour obtenir une description de l’erreur, appelez la fonction WNetGetLastError .
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.

Remarques

La fonction WNetDisconnectDialog retourne immédiatement et crée une boîte de dialogue pour déconnecter les lecteurs en réseau. Cette boîte de dialogue s’exécute de manière asynchrone sur un thread de travail.

Si le thread de travail est terminé, la fenêtre propriétaire et la boîte de dialogue associée sont également terminées. Si cela se produit, l’utilisateur peut ne pas être en mesure d’interagir avec la boîte de dialogue, car elle n’apparaîtra pas sur l’écran de l’utilisateur ou apparaîtra brièvement.

Configuration requise


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