Fonction WNetConnectionDialog (winnetwk.h)

Article
08/27/2023

La fonction WNetConnectionDialog démarre une boîte de dialogue de navigation générale pour la connexion aux ressources réseau. La fonction nécessite un handle pour la fenêtre propriétaire pour la boîte de dialogue.

Syntaxe

DWORD WNetConnectionDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Paramètres

[in] hwnd

Gérer vers la fenêtre propriétaire de la boîte de dialogue.

[in] dwType

Type de ressource auquel autoriser les connexions. Ce paramètre peut être la valeur suivante.

Valeur	Signification
RESOURCETYPE_DISK	Connexions aux ressources de disque.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR. Si l’utilisateur annule la boîte de dialogue, la fonction retourne –1.

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
ERROR_EXTENDED_ERROR	Une erreur spécifique au réseau s’est produite. Pour obtenir une description de l’erreur, appelez la fonction WNetGetLastError .
ERROR_INVALID_PASSWORD	Le mot de passe spécifié n’est pas valide.
ERROR_NO_NETWORK	Le réseau n'est pas disponible.
ERROR_NOT_ENOUGH_MEMORY	La mémoire est insuffisante pour démarrer la boîte de dialogue.

Remarques

Si l’utilisateur clique sur OK dans la boîte de dialogue, la connexion réseau demandée a été établie lorsque la fonction WNetConnectionDialog est retournée.

Si la fonction tente d’effectuer une connexion et que le fournisseur réseau retourne le message ERROR_INVALID_PASSWORD, le système invite l’utilisateur à entrer un mot de passe. Le système utilise le nouveau mot de passe dans une autre tentative de connexion.

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