DISCDLGSTRUCT

The DISCDLGSTRUCT data structure is used in the WNetDisconnectDialog1 function to describe the required behavior for the disconnect attempt.

typedef struct _DISCDLGSTRUCT{
    DWORD cbStructure;
    HWND hwndOwner;
    LPTSTR lpLocalName;
    LPTSTR lpRemoteName;
    DWORD dwFlags;
} DISCDLGSTRUCT,  *LPDISCDLGSTRUCT;
 

Members

cbStructure

The size, in bytes, of the DISCDLGSTRUCT structure. This structure is filled in by the caller to indicate the size of the structure passed in.

hwndOwner

This specifies the handle to the owning window.

lpRemoteName

Specifies the network resource to disconnect. This member may be set to NULL if lpLocalName is specified. When this occurs, the connection to the resource redirected from lpLocalName is disconnected.

lpLocalName

The local device name that is redirected to the network resource, such as "F:" or "LPT1".

dwFlags

This member can be any combination of the following values:

Value	Meaning
DISC_UPDATE_PROFILE	If this value is set, the connection is no longer persistent (automatically restored every time the user logs on). This flag is valid only if lpLocalName specifies a local device.
DISC_NO_FORCE	If this value is not set, force will be applied when attempting to disconnect (typically because the user has open files). The user will be informed if there are open files to the connection and asked if he or she still wants to disconnect. If so, the disconnect procedure re-attempts with additional force.

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.

See Also

Windows Networking (WNet) Overview, Windows Networking Structures