USE_INFO_1 结构 (lmuse.h)

项目
08/24/2023

USE_INFO_1结构包含有关本地设备和共享资源之间的连接的信息。该信息包括连接状态和连接类型。

语法

typedef struct _USE_INFO_1 {
  LMSTR ui1_local;
  LMSTR ui1_remote;
  LMSTR ui1_password;
  DWORD ui1_status;
  DWORD ui1_asg_type;
  DWORD ui1_refcount;
  DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;

成员

ui1_local

类型： LMSTR

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

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

ui1_remote

类型： LMSTR

指向包含所访问的远程资源的共享名称的字符串的指针。字符串采用以下形式：

\\servername\sharename

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

ui1_password

类型： LMSTR

指向字符串的指针，该字符串包含在特定工作站和服务器之间建立会话所需的密码。

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

ui1_status

类型：DWORD

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

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

ui1_asg_type

类型：DWORD

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

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

ui1_refcount

类型：DWORD

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

ui1_usecount

类型：DWORD

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

注解

指定为 NULL的ui1_local成员请求对服务器进行身份验证，而不重定向驱动器号或设备。在相同连接生效时涉及服务器的未来重定向将使用 ui1_password 成员在对 NetUseAdd 函数的初始调用中指定的密码。

要求


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

另请参阅

通过

USE_INFO_1 结构 (lmuse.h)

语法

成员

注解

要求

另请参阅

反馈

其他资源