Structure DISCDLGSTRUCTW (winnetwk.h)

Article
03/04/2024

La structure DISCDLGSTRUCT est utilisée dans la fonction WNetDisconnectDialog1 . La structure contient les informations requises pour la tentative de déconnexion.

Syntaxe

typedef struct _DISCDLGSTRUCTW {
  DWORD  cbStructure;
  HWND   hwndOwner;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  DWORD  dwFlags;
} DISCDLGSTRUCTW, *LPDISCDLGSTRUCTW;

Membres

cbStructure

Type : DWORD

Taille, en octets, de la structure DISCDLGSTRUCT . L’appelant doit fournir cette valeur.

hwndOwner

Type : HWND

Handle de la fenêtre propriétaire de la boîte de dialogue.

lpLocalName

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui spécifie le nom de l’appareil local qui est redirigé vers la ressource réseau, par exemple « F : » ou « LPT1 ».

lpRemoteName

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui spécifie le nom de la ressource réseau à déconnecter. Ce membre peut être NULL si le membre lpLocalName est spécifié. Lorsque lpLocalName est spécifié, la connexion à la ressource réseau redirigée à partir de lpLocalName est déconnectée.

dwFlags

Type : DWORD

Ensemble d’indicateurs de bits décrivant la connexion. Ce membre peut être une combinaison des valeurs suivantes.

Valeur	Signification
DISC_UPDATE_PROFILE	Si cette valeur est définie, la connexion spécifiée n’est plus persistante (restaurée automatiquement chaque fois que l’utilisateur se connecte). Cet indicateur est valide uniquement si le membre lpLocalName spécifie un appareil local.
DISC_NO_FORCE	Si cette valeur n’est pas définie, le système applique une force lors de la tentative de déconnexion de la ressource réseau. Cette situation se produit généralement lorsque l’utilisateur a des fichiers ouverts via la connexion. Cette valeur signifie que l’utilisateur est informé s’il existe des fichiers ouverts sur la connexion et lui demande s’il souhaite toujours se déconnecter. Si l’utilisateur souhaite continuer, la procédure de déconnexion tente à nouveau avec une force supplémentaire.

Valeur

Signification

DISC_UPDATE_PROFILE

Si cette valeur est définie, la connexion spécifiée n’est plus persistante (restaurée automatiquement chaque fois que l’utilisateur se connecte). Cet indicateur est valide uniquement si le membre lpLocalName spécifie un appareil local.

DISC_NO_FORCE

Si cette valeur n’est pas définie, le système applique une force lors de la tentative de déconnexion de la ressource réseau.

Cette situation se produit généralement lorsque l’utilisateur a des fichiers ouverts via la connexion. Cette valeur signifie que l’utilisateur est informé s’il existe des fichiers ouverts sur la connexion et lui demande s’il souhaite toujours se déconnecter. Si l’utilisateur souhaite continuer, la procédure de déconnexion tente à nouveau avec une force supplémentaire.

Remarques

Notes

L’en-tête winnetwk.h définit DISCDLGSTRUCT en tant qu’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. La combinaison 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]
En-tête	winnetwk.h

Voir aussi

WNetDisconnectDialog1

Vue d’ensemble de Windows Networking (WNet)

Structures de mise en réseau Windows

Partager via