(lmuse.h) USE_INFO_2 结构

  • 项目

USE_INFO_2 结构包含有关本地计算机与共享资源之间的连接的信息，包括连接类型、连接状态、用户名和域名。

语法

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

成员

ui2_local

类型： LMSTR

指向包含本地设备名称 (的字符串的指针，例如，驱动器 E 或 LPT1) 重定向到共享资源。 常量 DEVLEN 指定字符串中的最大字符数。 此成员可以为 NULL。 有关更多信息，请参见下面的“备注”部分。

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

ui2_remote

类型： LMSTR

指向包含远程资源的共享名称的字符串的指针。 字符串的格式为

\\servername\sharename

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

ui2_password

类型： LMSTR

指向字符串的指针，该字符串包含建立与特定工作站的会话所需的密码。

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

ui2_status

类型：DWORD

连接的状态。 NetUseAdd 函数不使用此元素。 定义了以下值。

值 含义
USE_OK
 连接成功。
USE_PAUSED
 由本地工作站暂停。
USE_SESSLOST
 已断开连接。
USE_DISCONN
 出现了错误。
USE_NETERR
 发生网络错误。
USE_CONN
 正在建立连接。
USE_RECONN
 正在重新连接。

ui2_asg_type

类型：DWORD

正在访问的远程资源的类型。 此成员可以是以下值之一。

值 含义
USE_WILDCARD
 匹配服务器的共享资源的类型。 通配符只能与 NetUseAdd 函数一起使用，并且仅当 ui2_local 成员为 NULL 字符串时。 有关更多信息，请参见下面的“备注”部分。
USE_DISKDEV
 磁盘设备。
USE_SPOOLDEV
 假脱机打印机。
USE_IPC
 IPC) (进程间通信。

ui2_refcount

类型：DWORD

在远程资源上打开的文件、目录和其他进程数。 NetUseAdd 函数不使用此元素。

ui2_usecount

类型：DWORD

使用本地设备名称 (重定向的显式连接数) 或隐式 UNC 连接 (重定向，而不使用资源建立的本地设备名称) 。

ui2_username

类型： LPWSTR

指向字符串的指针，该字符串包含发起连接的用户的名称。

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

ui2_domainname

类型： LMSTR

指向包含远程资源的域名的字符串的指针。

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

注解

指定为 NULL的ui2_local成员请求向服务器进行身份验证，而不重定向驱动器号或设备。 当同一连接生效时涉及服务器的未来重定向将使用在对 NetUseAdd 函数的初始调用中指定的身份验证信息。 此信息包括 ui2_password、 ui2_username和 ui2_domainname 成员的组合。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 lmuse.h (包括 Lm.h)

另请参阅

NetUseAdd

NetUseEnum

NetUseGetInfo

网络管理概述

网络管理结构

使用函数