WNetDisconnectDialog1

The WNetDisconnectDialog1 function attempts to disconnect from a network resource. If the underlying network returns WN_OPEN_FILES, the function prompts the user for confirmation. If there is any error, it informs the user.

DWORD WNetDisconnectDialog1(
  LPDISCDLGSTRUCT lpDiscDlgStruc  // pointer to structure
);

Parameters

lpDiscDlgStruct
Pointer to the DISCDLGSTRUCT data structure, which specifies the behavior for the disconnect attempt.

Return Values

WN_SUCCESS if the connection is successfully disconnected. Error codes include the following.

Value Meaning
WN_CANCEL After the user was prompted for a decision to disconnect, the user elected not to disconnect.
WN_OPEN_FILES Unable to disconnect because the user is actively using the connection.
WN_FUNCTION_BUSY The network provider is busy (possibly initializing). The caller should retry.
WN_NO_NETWORK The network is not present.
WN_OUT_OF_MEMORY There is not enough memory to bring up the dialog.
WN_EXTENDED_ERROR A network specific error occurred. Call WNetGetLastError to obtain a description of the error.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Use version 2.0 or later.
  Header: Declared in winnetwk.h.
  Import Library: Use mpr.lib.

See Also

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