Fonction WNetConnectionDialog1W (winnetwk.h)
La fonction WNetConnectionDialog1 affiche une boîte de dialogue de navigation générale pour la connexion aux ressources réseau. La fonction nécessite un CONNECTDLGSTRUCT pour établir les paramètres de la boîte de dialogue.
Syntaxe
DWORD WNetConnectionDialog1W(
[in, out] LPCONNECTDLGSTRUCTW lpConnDlgStruct
);
Paramètres
[in, out] lpConnDlgStruct
Pointeur vers une structure CONNECTDLGSTRUCT . La structure établit les paramètres de boîte de dialogue de navigation.
Valeur retournée
Si l’utilisateur annule la boîte de dialogue, la fonction retourne –1. Si la fonction réussit, elle retourne NO_ERROR. En outre, si l’appel réussit, le membre dwDevNum de la structure CONNECTDLGSTRUCT contient le numéro de l’appareil connecté.
En règle générale, cette boîte de dialogue retourne une erreur uniquement si l’utilisateur ne peut pas entrer une session de dialogue. En effet, les erreurs qui se produisent après une session de dialogue sont signalées directement à l’utilisateur. 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 |
---|---|
|
Les options de boîte de dialogue CONNDLG_RO_PATH et CONNDLG_USE_MRU sont définies. (Les options de boîte de dialogue sont spécifiées par le membre dwFlags de la structure CONNECTDLGSTRUCT .) -ou- Les options de boîte de dialogue CONNDLG_PERSIST et CONNDLG_NOT_PERSIST sont définies. -ou- L’option de boîte de dialogue CONNDLG_RO_PATH est définie et le membre lpRemoteName de la structure NETRESOURCE ne pointe pas vers un réseau distant. (La structure CONNECTDLGSTRUCT pointe vers une structure NETRESOURCE .) |
|
Le membre dwType de la structure NETRESOURCE n’est pas défini sur RESOURCETYPE_DISK. |
|
Le fournisseur réseau est occupé (éventuellement en initialisation). L’appelant doit réessayer. |
|
Le réseau n'est pas disponible. |
|
La mémoire est insuffisante pour afficher la boîte de dialogue. |
|
Une erreur spécifique au réseau s’est produite. Appelez WNetGetLastError pour obtenir une description de l’erreur. |
Remarques
Notes
L’en-tête winnetwk.h définit WNetConnectionDialog1 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] |
Plateforme cible | Windows |
En-tête | winnetwk.h |
Bibliothèque | Mpr.lib |
DLL | Mpr.dll |