Platform SDK: Windows Networking

WNetAddConnection

The WNetAddConnection function enables the calling application to connect a local device to a network resource. A successful connection is persistent, meaning that the system automatically restores the connection during subsequent logon operations.

Note  This function is provided only for compatibility with 16-bit versions of Windows. Win32-based applications should call the WNetAddConnection2 or the WNetAddConnection3 function.

DWORD WNetAddConnection(
  LPCTSTR lpRemoteName, // network device name
  LPCTSTR lpPassword,   // password
  LPCTSTR lpLocalName   // local device name
);

Parameters

lpRemoteName
[in] Pointer to a constant null-terminated string that specifies the network resource to connect to.
lpPassword
[in] Pointer to a constant null-terminated string that specifies the password to be used to make a connection. This parameter is usually the password associated with the current user.

If this parameter is NULL, the default password is used. If the string is empty, no password is used.

Windows 95/98: This parameter must be NULL or an empty string.

lpLocalName
[in] Pointer to a constant null-terminated string that specifies the name of a local device to be redirected, such as "F:" or "LPT1". The string is treated in a case-insensitive manner. If the string is NULL, a connection to the network resource is made without redirecting the local device.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value can be one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED Access is denied.
ERROR_ALREADY_ASSIGNED The device specified in the lpLocalName parameter is already connected.
ERROR_BAD_DEV_TYPE The device type and the resource type do not match.
ERROR_BAD_DEVICE The value specified in the lpLocalName parameter is invalid.
ERROR_BAD_NET_NAME The value specified in the lpRemoteName parameter is not valid or cannot be located.
ERROR_BAD_PROFILE The user profile is in an incorrect format.
ERROR_CANNOT_OPEN_PROFILE The system is unable to open the user profile to process persistent connections.
ERROR_DEVICE_ALREADY_REMEMBERED An entry for the device specified in the lpLocalName parameter is already in the user profile.
ERROR_EXTENDED_ERROR A network-specific error occurred. To obtain a description of the error, call the WNetGetLastError function.
ERROR_INVALID_PASSWORD The specified password is invalid.
ERROR_NO_NET_OR_BAD_PATH The operation cannot be performed because a network component is not started or because a specified name cannot be used.
ERROR_NO_NETWORK The network is unavailable.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Winnetwk.h.
  Library: Use Mpr.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Windows Networking (WNet) Overview, Windows Networking Functions, WNetAddConnection2, WNetAddConnection3, WNetCancelConnection, WNetCancelConnection2, WNetGetConnection