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 结构的所有其他成员都必须设置为 NULLdwType 成员必须等于 RESOURCETYPE_DISK。

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

dwFlags

类型:DWORD

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

含义
SidTypeUser
该帐户是用户帐户。
CONNDLG_RO_PATH
显示只读路径,而不是允许用户键入路径。

仅当 lpConnRes 成员指向的 NETRESOURCE 结构的 lpRemoteName 成员不是 NULL (或) 为空字符串且未设置CONNDLG_USE_MRU标志时,才应设置此标志。

CONNDLG_CONN_POINT
内部标志。 请勿使用。
CONNDLG_USE_MRU
在组合框中输入最近使用的路径。 设置此值以模拟 WNetConnectionDialog 函数。
CONNDLG_HIDE_BOX
显示检查框,允许用户在登录时还原连接。
CONNDLG_PERSIST
在登录时还原连接。
CONNDLG_NOT_PERSIST
不要在登录时还原连接。
 

有关更多信息,请参见下面的“备注”部分。

dwDevNum

类型:DWORD

如果对 WNetConnectionDialog1 函数的调用成功,则此成员返回连接的设备编号。 值 1 表示 A:,2 表示 B:,3 表示 C:,依依。 如果用户进行了无设备连接,则值为 –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 网络结构