STRUCTURE CONNECTDLGSTRUCTA (winnetwk.h)
La structure CONNECTDLGSTRUCT est utilisée par la fonction WNetConnectionDialog1 pour établir des 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
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 être définis sur NULL. Le membre dwType
Le système ne prend pas en charge l’indicateur de 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 de 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 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 membre lpConnRes n’est pas NULL (ou une chaîne vide) et que l’indicateur CONNDLG_USE_MRU n’est pas défini. |
|
Indicateur interne. N’utilisez pas. |
|
Entrez les chemins les plus récemment utilisés dans la zone de combinaison. Définissez cette valeur pour simuler la fonction WNetConnectionDialog |
|
Activez la case à cocher permettant à l’utilisateur de restaurer la connexion à l’ouverture de session. |
|
Restaurez la connexion à l’ouverture de session. |
|
Ne restaurez pas la connexion à l’ouverture de session. |
Pour plus d’informations, consultez la section Remarques suivante.
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 aucun CONNDLG_RO_PATH ni l’indicateur de CONNDLG_USE_MRU n’est défini, et que le lpRemoteName membre de la structure NETRESOURCE ne spécifie pas de chemin d’accès distant, la requête correspond par défaut au 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 aucune des deux options n’est définie, la boîte de dialogue est définie par défaut sur la dernière option sélectionnée dans cette boîte de dialogue pour le type particulier de connexion d’appareil.
Note
L’en-tête winnetwk.h définit CONNECTDLGSTRUCT 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
Vue d’ensemble mise en réseau Windows (WNet)