Export (0) Print
Expand All

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 codeDescription
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]

Header

Winnetwk.h

Library

Mpr.lib

DLL

Mpr.dll

Unicode and ANSI names

WNetDisconnectDialog1W (Unicode) and WNetDisconnectDialog1A (ANSI)

See also

Windows Networking (WNet) Overview
Windows Networking Functions
WNetConnectionDialog
WNetConnectionDialog1
DISCDLGSTRUCT
WNetDisconnectDialog

 

 

Community Additions

ADD
Show:
© 2014 Microsoft