WNetConnectionDialog1 function

The WNetConnectionDialog1 function brings up a general browsing dialog for connecting to network resources. The function requires a CONNECTDLGSTRUCT to establish the dialog box parameters.

Syntax

C++
Copy 

DWORD WNetConnectionDialog1(
  _Inout_ LPCONNECTDLGSTRUCT lpConnDlgStruct
);

Parameters

lpConnDlgStruct [in, out]

Pointer to a CONNECTDLGSTRUCT structure. The structure establishes the browsing dialog parameters.

Return value

If the user cancels the dialog box, the function returns –1. If the function is successful, it returns NO_ERROR. Also, if the call is successful, the dwDevNum member of the CONNECTDLGSTRUCT structure contains the number of the connected device.

Typically this dialog returns an error only if the user cannot enter a dialog session. This is because errors that occur after a dialog session are reported to the user directly. If the function fails, the return value is a system error code, such as one of the following values.

Return codeDescription
ERROR_INVALID_PARAMETER

Both the CONNDLG_RO_PATH and the CONNDLG_USE_MRU dialog box options are set. (Dialog box options are specified by the dwFlags member of the CONNECTDLGSTRUCT structure.)

-or-

Both the CONNDLG_PERSIST and the CONNDLG_NOT_PERSIST dialog box options are set.

-or-

The CONNDLG_RO_PATH dialog box option is set and the lpRemoteName member of the NETRESOURCE structure does not point to a remote network. (The CONNECTDLGSTRUCT structure points to a NETRESOURCE structure.)

ERROR_BAD_DEV_TYPE

The dwType member of the NETRESOURCE structure is not set to RESOURCETYPE_DISK.

ERROR_BUSY

The network provider is busy (possibly initializing). The caller should retry.

ERROR_NO_NETWORK

The network is unavailable.

ERROR_NOT_ENOUGH_MEMORY

There is insufficient memory to display the dialog box.

ERROR_EXTENDED_ERROR

A network-specific error occurred. Call WNetGetLastError to obtain a description of the error.

 

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

Unicode and ANSI names

WNetConnectionDialog1W (Unicode) and WNetConnectionDialog1A (ANSI)

See also

Windows Networking (WNet) Overview
Windows Networking Functions
CONNECTDLGSTRUCT
NETRESOURCE
WNetConnectionDialog
WNetDisconnectDialog

 

 

Community Additions

ADD
Show: