WNetDisconnectDialog

This function starts a general browsing dialog box for disconnecting from network resources. It lists all currently connected and remembered resources and lets the user select which one to disconnect.

At a Glance

Header file: Winnetwk.h
Windows CE versions: 2.0 and later

Syntax

DWORD WNetDisconnectDialog( HWND hwnd DWORD dwType );

Parameters

hwnd

[in] Handle to the owning window.

dwType

[in] Ignored; set to zero.

Return Values

ERROR_SUCCESS indicates success. 0xFFFFFFFF indicates that the user canceled out of the dialog box. An error value indicates failure. To get extended error information, call GetLastError. Possible GetLastError error values are described in the following table.

Value Meaning
ERROR_NO_NETWORK No network is present.
ERROR_NOT_ENOUGH_MEMORY There is insufficient memory to start the dialog box.

Remarks

If the user chooses OK in the dialog box, the requested network disconnection will have been made when WNetDisconnectDialog returns.