WNetDisconnectDialog1 function
The WNetDisconnectDialog1 function attempts to disconnect a network resource. If the underlying network returns ERROR_OPEN_FILES, the function prompts the user for confirmation. If there is any error, the function informs the user. The function requires a DISCDLGSTRUCT to specify the parameters for the disconnect attempt.
Syntax
DWORD WNetDisconnectDialog1( _In_ LPDISCDLGSTRUCT lpConnDlgStruct );
Parameters
- lpConnDlgStruct [in]
-
Pointer to a DISCDLGSTRUCT structure. The structure specifies the behavior for the disconnect attempt.
Return value
If the function succeeds, the return value is NO_ERROR. If the user cancels the dialog box, the return value is –1.
If the function fails, the return value is a system error code, such as one of the following values.
| Return code | Description |
|---|---|
|
When the system prompted the user for a decision about disconnecting, the user elected not to disconnect. |
|
Unable to disconnect because the user is actively using the connection. |
|
The network provider is busy (possibly initializing). The caller should retry. |
|
The network is unavailable. |
|
There is insufficient memory to start the dialog box. |
|
A network-specific error occurred. Call the WNetGetLastError function to obtain a description of the error. |
Requirements
|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names | WNetDisconnectDialog1W (Unicode) and WNetDisconnectDialog1A (ANSI) |
See also
- Windows Networking (WNet) Overview
- Windows Networking Functions
- WNetConnectionDialog
- WNetConnectionDialog1
- DISCDLGSTRUCT
- WNetDisconnectDialog