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
描述对话框显示选项的一组位标志。 此成员可以是以下值的组合。
值 | 含义 |
---|---|
|
该帐户是用户帐户。 |
|
显示只读路径,而不是允许用户键入路径。
仅当 lpConnRes 成员指向的 NETRESOURCE 结构的 lpRemoteName 成员不是 NULL (或) 为空字符串且未设置CONNDLG_USE_MRU标志时,才应设置此标志。 |
|
内部标志。 请勿使用。 |
|
在组合框中输入最近使用的路径。 设置此值以模拟 WNetConnectionDialog 函数。 |
|
显示检查框,允许用户在登录时还原连接。 |
|
在登录时还原连接。 |
|
不要在登录时还原连接。 |
有关更多信息,请参见下面的“备注”部分。
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 |