WNetConnectionDialog function

The WNetConnectionDialog function starts a general browsing dialog box for connecting to network resources. The function requires a handle to the owner window for the dialog box.

Syntax

DWORD WNetConnectionDialog(
  HWND  hwnd,
  DWORD dwType
);

Parameters

hwnd

Handle to the owner window for the dialog box.

dwType

Resource type to allow connections to. This parameter can be the following value.

Value Meaning
RESOURCETYPE_DISK
Connections to disk resources.

Return Value

If the function succeeds, the return value is NO_ERROR. If the user cancels the dialog box, the function returns –1.

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

Return code Description
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_NETWORK
The network is unavailable.
ERROR_NOT_ENOUGH_MEMORY
There is insufficient memory to start the dialog box.

Remarks

If the user clicks OK in the dialog box, the requested network connection will have been made when the WNetConnectionDialog function returns.

If the function attempts to make a connection and the network provider returns the message ERROR_INVALID_PASSWORD, the system prompts the user to enter a password. The system uses the new password in another attempt to make the connection.

Requirements

   
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

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

Windows Networking (WNet) Overview

Windows Networking Functions