通过

CONNECTDLGSTRUCTA 结构 （winnetwk.h）

  • 项目

WNetConnectionDialog1 函数使用 CONNECTDLGSTRUCT 结构来建立浏览对话框参数。

语法

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

成员

cbStructure

类型：DWORD

CONNECTDLGSTRUCT 结构的大小（以字节为单位）。 调用方必须提供此值。

hwndOwner

类型：HWND

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

lpConnRes

类型：LPNETRESOURCE

指向 NETRESOURCE 结构的指针。

如果指定 NETRESOURCE 的 lpRemoteName 成员，则会将其输入到对话框的路径字段中。 除 dwType 成员之外，NETRESOURCE 结构的所有其他成员都必须设置为 NULL。 dwType 成员必须等于RESOURCETYPE_DISK。

系统不支持用于浏览和连接到打印资源的 RESOURCETYPE_PRINT 标志。

dwFlags

类型：DWORD

描述对话框显示选项的一组位标志。 此成员可以是以下值的组合。

价值 意义
SidTypeUser
 该帐户是用户帐户。
CONNDLG_RO_PATH
 显示只读路径，而不是允许用户在路径中键入。

仅当 NETRESOURCE 结构所 指向的 lpRemoteName 成员未 NULL（或空字符串）且未设置 CONNDLG_USE_MRU 标志时，才应设置此标志。
CONNDLG_CONN_POINT
 内部标志。 请勿使用。
CONNDLG_USE_MRU
 在组合框中输入最近使用的路径。 设置此值以模拟 WNetConnectionDialog 函数。
CONNDLG_HIDE_BOX
 显示复选框，允许用户在登录时还原连接。
CONNDLG_PERSIST
 在登录时还原连接。
CONNDLG_NOT_PERSIST
 请勿在登录时还原连接。
 

有关详细信息，请参阅以下“备注”部分。

dwDevNum

类型：DWORD

如果对 WNetConnectionDialog1 函数的调用成功，此成员将返回连接的设备数。 对于 A：，2 表示 B：，3 表示 C：，依此为 1。 如果用户进行了无设备连接，则值为 –1。

言论

如果未设置CONNDLG_RO_PATH和CONNDLG_USE_MRU标志，并且 NETRESOURCE 结构的 lpRemoteName 成员未指定远程路径，则请求默认为CONNDLG_RO_PATH对话框显示类型。

无法设置CONNDLG_PERSIST和CONNDLG_NOT_PERSIST值。 如果两者均未设置，则对话框默认为此对话框中为特定类型的设备连接选择的最后一个选项。

注意

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

要求

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

另请参阅

NETRESOURCE

WNetConnectionDialog1

Windows 网络（WNet）概述

Windows 网络结构