Fonction WNetConnectionDialog (winnetwk.h)
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 |
|---|---|
|
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 |
|---|---|
|
Une erreur spécifique au réseau s’est produite. Pour obtenir une description de l’erreur, appelez la fonction WNetGetLastError . |
|
Le mot de passe spécifié n’est pas valide. |
|
Le réseau n'est pas disponible. |
|
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 |