WNetConnectionDialog1

This function brings up a general browsing dialog for connecting to network resources.

DWORD WNetConnectionDialog1 (
    LPCONNECTDLGSTRUCT lpConnectDlgStruct
    );

typedef struct { 
    DWORD cbStructure;
    HWND hwndOwner;
    LPNETRESOURCE lpConnRes;
    DWORD dwFlags;
    DWORD dwDevNum;
} CONNECTDLGSTRUCT, FAR *LPCONNECTDLGSTRUCT;

cbStructure

Contains the size of this structure in bytes.

hwndOwner

This specifies the HWND of the owning window.

lpConnRes

A NETRESOURCE structure. If lpConnRes.lpRemoteName is specified, this field will be entered into the path field of the dialog. All other fields must be set to NULL except lpConnRes.dwType which specifies the type of resources of interest, and must be one of:

RESOURCETYPE_DISK	Connect to disk resources.
RESOURCETYPE_PRINT	Connect to print resources.

dwFlags

Specifies variations in the dialog display. To simulate WNetConnectionDialog, set this to CONNDLG_USE_MRU. Currently, this may be one of:

CONNDLG_RO_PATH	Instead of allowing user to type in flag, have a read only path already inserted. This flag should only be set if lpConnRes.lpRemoteName is not NULL (or an empty string), and CONNDLG_USE_MRU is not set.
CONNDLG_CONN_POINT	Internal flag. Do not use.
CONNDLG_USE_MRU	Fill up the combobox, listing most recently used paths.
CONNDLG_HIDE_BOX	Show the checkbox allowing the user to select whether or not the connection should be restored at logon.
CONNDLG_PERSIST	Set if the connection is to be restored at logon.
CONNDLG_NOT_PERSIST	Set if the connection is not to be restored at logon.

dwDevNum

If call is successful, this returns the number of the device connected to.

If neither CONNDLG_RO_PATH or CONNDLG_USE_MRU is set in dwFlags, then the request defaults to CONNDLG_RO_PATH if lpConnRes.lpRemoteName does not specify a remote path and to CONNDLG_USE_MRU otherwise. CONNDLG_PERSIST and CONNDLG_NOT_PERSIST cannot both be set. If neither is set, then the dialog defaults to the last option that was selected on this dialog for the particular type of device being connected.

WN_SUCCESS if the call is successful in bringing up the dialog. Other error codes include the following. Typically this dialog will only return an error if the dialog could not be brought up since errors that occur thereafter are reported to the user directly. If the call is sucessful, dwDevNum will contain the number of the device connected to.

WN_BAD_VALUE	one of the following: CONNDLG_RO_PATH is set and either CONNDLG_USE_MRU is set or lpConnRes.lpRemoteName does not point to a remote name; both CONNDLG_PERSIST and CONNDLG_NOT_PERSIST are set.
WN_BAD_DEV_TYPE	lpConnRes.dwType is not set to either RESOURCETYPE_DISK or RESOURCETYPE_PRINT.
WN_FUNCTION_BUSY	The MPR or NP is busy (possibly initializing). The caller should retry.
WN_NO_NETWORK	network is not present.
WN_OUT_OF_MEMORY	insufficient memory to bring up the dialog.
WN_EXTENDED_ERROR	a network specific error occurred. WNetGetLastError should be called to obtain a description of the error.

WNetConnectionDialog1

See Also