通过

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 网络结构