WNetDisconnectDialog1W 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 WNetDisconnectDialog1W(
  LPDISCDLGSTRUCTW lpConnDlgStruct
);

Parameters

lpConnDlgStruct

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
ERROR_CANCELLED
When the system prompted the user for a decision about disconnecting, the user elected not to disconnect.
ERROR_OPEN_FILES
Unable to disconnect because the user is actively using the connection.
ERROR_BUSY
The network provider is busy (possibly initializing). The caller should retry.
ERROR_NO_NETWORK
The network is unavailable.
ERROR_NOT_ENOUGH_MEMORY
There is insufficient memory to start the dialog box.
ERROR_EXTENDED_ERROR
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]
Target Platform Windows
Header winnetwk.h
Library Mpr.lib
DLL Mpr.dll

See Also

DISCDLGSTRUCT

WNetConnectionDialog

WNetConnectionDialog1

WNetDisconnectDialog

Windows Networking (WNet) Overview

Windows Networking Functions