WNetConnectionDialog function
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.
Syntax
DWORD WNetConnectionDialog( _In_ HWND hwnd, _In_ DWORD dwType );
Parameters
- hwnd [in]
-
Handle to the owner window for the dialog box.
- dwType [in]
-
Resource type to allow connections to. This parameter can be the following value.
Value Meaning - RESOURCETYPE_DISK
Connections to disk resources.
Return value
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.
| Return code | Description |
|---|---|
|
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. |
Remarks
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.
Requirements
|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Windows Networking (WNet) Overview
- Windows Networking Functions
- WNetAddConnection3
- WNetCancelConnection2
- WNetDisconnectDialog