STRUCTURE DISCDLGSTRUCTA (winnetwk.h)

Article
11/20/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 _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

Membres

cbStructure

Type : DWORD

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

hwndOwner

Type : HWND

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

lpLocalName

Type : LPTSTR

Pointeur vers une chaîneNULL -terminated qui spécifie le nom de l’appareil local redirigé vers la ressource réseau, par exemple « F : » ou « LPT1 ».

lpRemoteName

Type : LPTSTR

Pointeur vers une chaîne null NULL-terminated qui spécifie le nom de la ressource réseau à déconnecter. Ce membre peut être NULL si le lpLocalName membre 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 lpLocalName membre spécifie un appareil local.
DISC_NO_FORCE	Si cette valeur n’est pas définie, le système applique la 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 sera informé s’il y a des fichiers ouverts sur la connexion et demandé s’il souhaite toujours se déconnecter. Si l’utilisateur souhaite continuer, la procédure de déconnexion tente de réessayer 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 lpLocalName membre spécifie un appareil local.

DISC_NO_FORCE

Si cette valeur n’est pas définie, le système applique la 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 sera informé s’il y a des fichiers ouverts sur la connexion et demandé s’il souhaite toujours se déconnecter. Si l’utilisateur souhaite continuer, la procédure de déconnexion tente de réessayer avec une force supplémentaire.

Remarques

Note

L’en-tête winnetwk.h définit DISCDLGSTRUCT comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	winnetwk.h

Voir aussi

WNetDisconnectDialog1

Vue d’ensemble mise en réseau Windows (WNet)

structures de mise en réseau Windows

Partager via