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.
DWORD WNetConnectionDialog1A( LPCONNECTDLGSTRUCTA lpConnDlgStruct );
Pointer to a CONNECTDLGSTRUCT structure. The structure establishes the browsing dialog parameters.
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.
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
Both the CONNDLG_PERSIST and the CONNDLG_NOT_PERSIST dialog box options are set.
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.)
||The dwType member of the NETRESOURCE structure is not set to RESOURCETYPE_DISK.|
||The network provider is busy (possibly initializing). The caller should retry.|
||The network is unavailable.|
||There is insufficient memory to display the dialog box.|
||A network-specific error occurred. Call WNetGetLastError to obtain a description of the error.|
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|