WNetConnectionDialog1A, fonction (winnetwk.h)

Article
11/20/2024

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 une 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 de la boîte de dialogue de navigation.

Valeur de retour

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. Cela est dû au fait que 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 , par exemple l’une des valeurs suivantes.

Retourner le code	Description
ERROR_INVALID_PARAMETER	Les options de CONNDLG_RO_PATH et de boîte de dialogue 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 CONNDLG_PERSIST et de boîte de dialogue 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 de réseau est occupé (éventuellement 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

Note

L’en-tête winnetwk.h définit WNetConnectionDialog1 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]
plateforme cible	Windows
d’en-tête	winnetwk.h
bibliothèque	Mpr.lib
DLL	Mpr.dll