DISCDLGSTRUCTA 结构 (winnetwk.h)

DISCDLGSTRUCT 结构用于 WNetDisconnectDialog1 函数。 该结构包含断开连接尝试所需的信息。

语法

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

成员

cbStructure

类型:DWORD

DISCDLGSTRUCT 结构的大小(以字节为单位)。 调用方必须提供此值。

hwndOwner

类型:HWND

对话框的所有者窗口的句柄。

lpLocalName

类型:LPTSTR

指向 NULL终止字符串的指针,该字符串指定重定向到网络资源的本地设备名称,例如“F:”或“LPT1”。

lpRemoteName

类型:LPTSTR

指向 NULL终止字符串的指针,该字符串指定要断开连接的网络资源的名称。 如果指定了 lpLocalName 成员,则此成员可以为 NULL。 指定 lpLocalName 时,从 lpLocalName 重定向到的网络资源的连接断开。

dwFlags

类型:DWORD

描述连接的一组位标志。 此成员可以是以下值的组合。

价值 意义
DISC_UPDATE_PROFILE
如果设置了此值,则指定的连接不再是永久性连接(每次用户登录时自动还原)。 仅当 lpLocalName 成员指定本地设备时,此标志才有效。
DISC_NO_FORCE
如果未设置此值,则系统在尝试断开与网络资源的连接时应用强制。

当用户通过连接打开文件时,通常会发生这种情况。 此值表示在连接上是否有打开的文件,并询问用户是否仍要断开连接。 如果用户想要继续,则断开连接过程会再次尝试并强制。

言论

注意

winnetwk.h 标头将 DISCDLGSTRUCT 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
标头 winnetwk.h

另请参阅

WNetDisconnectDialog1

Windows 网络(WNet)概述

Windows 网络结构