The WNetConnectionDialog function starts a general browsing dialog box for connecting to network resources. The function requires a handle to the owner window for the dialog box.
DWORD WNetConnectionDialog( HWND hwnd, DWORD dwType );
Handle to the owner window for the dialog box.
Resource type to allow connections to. This parameter can be the following value.
||Connections to disk resources.|
If the function succeeds, the return value is NO_ERROR. If the user cancels the dialog box, the function returns –1.
If the function fails, the return value is a system error code, such as one of the following values.
||A network-specific error occurred. To obtain a description of the error, call the WNetGetLastError function.|
||The specified password is invalid.|
||The network is unavailable.|
||There is insufficient memory to start the dialog box.|
If the user clicks OK in the dialog box, the requested network connection will have been made when the WNetConnectionDialog function returns.
If the function attempts to make a connection and the network provider returns the message ERROR_INVALID_PASSWORD, the system prompts the user to enter a password. The system uses the new password in another attempt to make the connection.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|