WNetConnectionDialog1A 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

DWORD WNetConnectionDialog1A(
  LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Parameters

lpConnDlgStruct

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 code Description
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]
Target Platform Windows
Header winnetwk.h
Library Mpr.lib
DLL Mpr.dll

See Also

CONNECTDLGSTRUCT

NETRESOURCE

WNetConnectionDialog

WNetDisconnectDialog

Windows Networking (WNet) Overview

Windows Networking Functions