WNetRestoreConnectionW function (winnetwk.h)

[WNetRestoreConnectionW is not available for use as of Windows Vista.]

The WNetRestoreConnectionW function restores the connection to a network resource. The function prompts the user, if necessary, for a name and password.


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


[in] hWnd

Handle to the parent window that the function uses to display the user interface (UI) that prompts the user for a name and password when making the network connection. If this parameter is NULL, there is no owner window.

[in] lpDevice

Pointer to a null-terminated Unicode string that specifies the local name of the drive to connect to, such as "Z:". If this parameter is NULL, the function reconnects all persistent drives stored in the registry for the current user.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is a system error code, such as one of the following values.

Return code Description
The caller does not have access to the network resource.
The local device specified by lpDevice is already connected to a network resource.
The type of local device and the type of network resource do not match.
The value specified by lpDevice is invalid.
The user profile is in an incorrect format.
The router or provider is busy, possibly initializing. The caller should retry.
The attempt to make the connection was canceled by the user through a dialog box from one of the network resource providers, or by a called resource.
The system is unable to open the user profile to process persistent connections.
An entry for the device is already in the user profile.
A network-specific error occurred. Call the WNetGetLastError function to obtain a description of the error.
The specified password is invalid.
The operation cannot be performed because a network component is not started or because a specified name cannot be used.
The network is unavailable.


The WNetRestoreConnectionW function is not supported on Windows Vista and later.

To call this function, first call the LoadLibrary function to load Mpr.dll. Then call the GetProcAddress function to retrieve the address of the WNetRestoreConnectionW function.

WNetRestoreConnectionW is used by Winlogon to restore all persistent drive mappings during the interactive logon process. The function is also called by the Microsoft Windows Shell to reconnect individual drives at the user's request. This can occur, for example, when a drive fails to reconnect at logon and the user double-clicks the drive under the My Computer virtual folder.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winnetwk.h
Library Mpr.lib
DLL Mpr.dll

See also

Windows Networking (WNet) Overview

Windows Networking Functions