WNetRestoreConnectionW, fonction (winnetwk.h)

Article
08/27/2023

[WNetRestoreConnectionW n’est pas disponible pour une utilisation à partir de Windows Vista.]

La fonction WNetRestoreConnectionW restaure la connexion à une ressource réseau. La fonction invite l’utilisateur, si nécessaire, à entrer un nom et un mot de passe.

Syntaxe

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

Paramètres

[in] hWnd

Gérez la fenêtre parente utilisée par la fonction pour afficher l’interface utilisateur qui invite l’utilisateur à entrer un nom et un mot de passe lors de l’établissement de la connexion réseau. Si ce paramètre a la valeur NULL, il n’existe aucune fenêtre propriétaire.

[in] lpDevice

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom local du lecteur auquel se connecter, par exemple « Z : ». Si ce paramètre a la valeur NULL, la fonction reconnecte tous les lecteurs persistants stockés dans le Registre pour l’utilisateur actuel.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

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_ACCESS_DENIED	L’appelant n’a pas accès à la ressource réseau.
ERROR_ALREADY_ASSIGNED	L’appareil local spécifié par lpDevice est déjà connecté à une ressource réseau.
ERROR_BAD_DEV_TYPE	Le type d’appareil local et le type de ressource réseau ne correspondent pas.
ERROR_BAD_DEVICE	La valeur spécifiée par lpDevice n’est pas valide.
ERROR_BAD_PROFILE	Le profil utilisateur est dans un format incorrect.
ERROR_BUSY	Le routeur ou le fournisseur est occupé, peut-être à l’initialisation. L’appelant doit réessayer.
ERROR_CANCELLED	La tentative d’établir la connexion a été annulée par l’utilisateur via une boîte de dialogue de l’un des fournisseurs de ressources réseau ou par une ressource appelée.
ERROR_CANNOT_OPEN_PROFILE	Le système ne peut pas ouvrir le profil utilisateur pour traiter les connexions persistantes.
ERROR_DEVICE_ALREADY_REMEMBERED	Une entrée pour l’appareil se trouve déjà dans le profil utilisateur.
ERROR_EXTENDED_ERROR	Une erreur spécifique au réseau s’est produite. Appelez la fonction WNetGetLastError pour obtenir une description de l’erreur.
ERROR_INVALID_PASSWORD	Le mot de passe spécifié n’est pas valide.
ERROR_NO_NET_OR_BAD_PATH	Impossible d’effectuer l’opération, car un composant réseau n’est pas démarré ou parce qu’un nom spécifié ne peut pas être utilisé.
ERROR_NO_NETWORK	Le réseau n'est pas disponible.

Remarques

La fonction WNetRestoreConnectionW n’est pas prise en charge sur Windows Vista et versions ultérieures.

Pour appeler cette fonction, appelez d’abord la fonction LoadLibrary pour charger Mpr.dll. Appelez ensuite la fonction GetProcAddress pour récupérer l’adresse de la fonction WNetRestoreConnectionW .

WNetRestoreConnectionW est utilisé par Winlogon pour restaurer tous les mappages de lecteurs persistants pendant le processus d’ouverture de session interactive. La fonction est également appelée par Microsoft Windows Shell pour reconnecter des lecteurs individuels à la demande de l’utilisateur. Cela peut se produire, par exemple, lorsqu’un lecteur ne parvient pas à se reconnecter à l’ouverture de session et que l’utilisateur double-clique sur le lecteur sous le dossier virtuel Poste de travail.

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

Voir aussi

Vue d’ensemble de Windows Networking (WNet)

Fonctions de mise en réseau Windows

Partager via