Platform SDK: Windows Networking |
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 );
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.
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. |
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.
Windows Networking (WNet) Overview, Windows Networking Functions, WNetAddConnection2, WNetAddConnection3, WNetCancelConnection, WNetCancelConnection2, WNetGetConnection