STRUCTURE CONNECTDLGSTRUCTA (winnetwk.h)
La structure CONNECTDLGSTRUCT est utilisée par la fonction WNetConnectionDialog1 pour établir les paramètres de boîte de dialogue de navigation.
Syntaxe
typedef struct _CONNECTDLGSTRUCTA {
DWORD cbStructure;
HWND hwndOwner;
LPNETRESOURCEA lpConnRes;
DWORD dwFlags;
DWORD dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;
Membres
cbStructure
Type : DWORD
Taille, en octets, de la structure CONNECTDLGSTRUCT . L’appelant doit fournir cette valeur.
hwndOwner
Type : HWND
Handle de la fenêtre propriétaire de la boîte de dialogue.
lpConnRes
Type : LPNETRESOURCE
Pointeur vers une structure NETRESOURCE .
Si le membre lpRemoteName de NETRESOURCE est spécifié, il est entré dans le champ chemin d’accès de la boîte de dialogue. À l’exception du membre dwType , tous les autres membres de la structure NETRESOURCE doivent avoir la valeur NULL. Le membre dwType doit être égal à RESOURCETYPE_DISK.
Le système ne prend pas en charge l’indicateur RESOURCETYPE_PRINT pour la navigation et la connexion aux ressources d’impression.
dwFlags
Type : DWORD
Ensemble d’indicateurs de bits qui décrivent les options pour l’affichage de la boîte de dialogue. Ce membre peut être une combinaison des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le compte est un compte d’utilisateur. |
|
Affichez un chemin d’accès en lecture seule au lieu d’autoriser l’utilisateur à taper un chemin d’accès.
Cet indicateur doit être défini uniquement si le membre lpRemoteName de la structure NETRESOURCE pointée par le membre lpConnRes n’est pas NULL (ou une chaîne vide) et si l’indicateur CONNDLG_USE_MRU n’est pas défini. |
|
Indicateur interne. Ne pas utiliser. |
|
Entrez les chemins d’accès les plus récents utilisés dans la zone de combinaison. Définissez cette valeur pour simuler la fonction WNetConnectionDialog . |
|
Affichez la zone case activée permettant à l’utilisateur de restaurer la connexion lors de l’ouverture de session. |
|
Restaurez la connexion lors de l’ouverture de session. |
|
Ne restaurez pas la connexion lors de l’ouverture de session. |
Pour plus d'informations, consultez la section Notes qui suit.
dwDevNum
Type : DWORD
Si l’appel à la fonction WNetConnectionDialog1 réussit, ce membre retourne le numéro de l’appareil connecté. La valeur est 1 pour A :, 2 pour B :, 3 pour C :, et ainsi de suite. Si l’utilisateur a créé une connexion sans appareil, la valeur est –1.
Remarques
Si ni le CONNDLG_RO_PATH ni l’indicateur CONNDLG_USE_MRU n’est défini et que le membre lpRemoteName de la structure NETRESOURCE ne spécifie pas de chemin d’accès distant, la demande est définie par défaut sur le type d’affichage de la boîte de dialogue CONNDLG_RO_PATH.
Les valeurs CONNDLG_PERSIST et CONNDLG_NOT_PERSIST ne peuvent pas être définies. Si aucun n’est défini, la boîte de dialogue utilise par défaut la dernière option sélectionnée dans cette boîte de dialogue pour le type particulier de connexion d’appareil.
Notes
L’en-tête winnetwk.h définit CONNECTDLGSTRUCT 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] |
| En-tête | winnetwk.h |