Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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(
  _In_  HWND hwnd,
  _In_  DWORD dwType
);

Parameters

hwnd [in]

Handle to the owner window for the dialog box.

dwType [in]

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

ValueMeaning
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 codeDescription
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]

Header

Winnetwk.h

Library

Mpr.lib

DLL

Mpr.dll

See also

Windows Networking (WNet) Overview
Windows Networking Functions
WNetAddConnection3
WNetCancelConnection2
WNetDisconnectDialog

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.