WNetDisconnectDialog
The WNetDisconnectDialog
function starts a general browsing dialog box for disconnecting from network
resources.
DWORD WNetDisconnectDialog(
|
HWND hwnd, |
// handle to window
owning dialog box |
|
DWORD dwType |
// resource type to
disconnect from |
|
); |
|
Parameters
hwnd
Identifies
the owning window.
dwType
Specifies the
resource type to disconnect from. This parameter may be one of the following
values:
|
Value |
Meaning |
|
RESOURCETYPE_DISK |
Disconnects
from disk resources. |
|
RESOURCETYPE_PRINT |
Disconnects
from print resources. |
Return Values
If the
function succeeds, the return value is NO_ERROR. If the user cancels out of the
dialog box, it is 0xFFFFFFFF.
If the
function fails, the return value is an error code. To get extended error
information, call GetLastError. GetLastError may return one of the following
error codes:
|
Value |
Meaning |
|
ERROR_EXTENDED_ERROR |
A
network-specific error occurred. To get a description of the error, use the WNetGetLastError function. |
|
ERROR_NO_NETWORK |
No network
is present. |
|
ERROR_NOT_ENOUGH_MEMORY |
There is
insufficient memory to start the dialog box. |
The function
returns error codes for compatibility with Windows version 3.1. For
compatibility with the Win32 API, the function also sets the error code value
returned by GetLastError.
Remarks
If the user
chooses OK in the dialog box, the requested network disconnections will have
been performed when WNetDisconnectDialog returns.
See Also