WNetConnectionDialog1A, fonction (winnetwk.h)

Article
03/08/2023

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 WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Paramètres

[in, out] lpConnDlgStruct

Pointeur vers une structure CONNECTDLGSTRUCT . La structure établit les paramètres du 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 renvoie 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, comme l’une des valeurs suivantes.

Code de retour	Description
ERROR_INVALID_PARAMETER	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 .)
ERROR_BAD_DEV_TYPE	Le membre dwType de la structure NETRESOURCE n’est pas défini sur RESOURCETYPE_DISK.
ERROR_BUSY	Le fournisseur réseau est occupé (éventuellement en initialisation). L’appelant doit réessayer.
ERROR_NO_NETWORK	Le réseau n'est pas disponible.
ERROR_NOT_ENOUGH_MEMORY	La mémoire est insuffisante pour afficher la boîte de dialogue.
ERROR_EXTENDED_ERROR	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 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


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