WNetConnectionDialog1 info Overview Group

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

DWORD WNetConnectionDialog1(

LPCONNECTDLGSTRUCT lpConnectDlgStruc	pointer to structure
);

Parameters

lpConnectDlgStruct: Pointer to the CONNECTDLGSTRUCT structure, which establishes the browsing dialog parameters.

Return Values

If the user cancels the dialog box, the function returns 0xFFFFFFFF. If the function is successful, it returns WN_SUCCESS. Also, if the call is sucessful, dwDevNum will contain the number of the connected device.

Typically this dialog will only return an error if the user cannot enter a dialog session. This is because errors that occur after a session are reported to the user directly. Error codes include the following.

Value	Meaning
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 RESOURCETYPE_DISK.
WN_FUNCTION_BUSY	The MPR or NP is busy (possibly initializing). The caller should retry.
WN_NO_NETWORK	The network is not present.
WN_OUT_OF_MEMORY	Insufficient memory to bring up the dialog.
WN_EXTENDED_ERROR	A network specific error occurred. Call WNetGetLastError to obtain a description of the error.

WNetConnectionDialog1 info Overview Group

Parameters

Return Values

See Also