SHARE_INFO_2结构 (lmshare.h)

项目
08/24/2023

包含有关共享资源的信息，包括资源的名称、类型和权限以及当前连接数。有关控制对安全对象的访问的详细信息，请参阅访问控制、特权和安全对象。

语法

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

成员

shi2_netname

指向指定资源共享名称的 Unicode 字符串的指针。对 NetShareSetInfo 函数的调用将忽略此成员。

shi2_type

指定共享资源类型的值的组合。对 NetShareSetInfo 函数的调用将忽略此成员。

可以指定以下值之一。可以使用 STYPE_MASK 值来隔离这些值。

值	含义
STYPE_DISKTREE	硬盘驱动器。
STYPE_PRINTQ	打印队列。
STYPE_DEVICE	通信设备。
STYPE_IPC	IPC) (进程间通信。

此外，还可以指定以下一个或两个值。

值	含义
STYPE_SPECIAL	为进程间通信保留的特殊共享 (IPC$) 或远程管理服务器 (ADMIN$) 。还可以引用管理共享，例如 C$、D$、E$等。有关详细信息，请参阅网络共享函数。
STYPE_TEMPORARY	临时共享。

shi2_remark

指向 Unicode 字符串的指针，该字符串包含有关共享资源的可选注释。

shi2_permissions

指定一个 DWORD 值，该值指示共享资源对运行具有共享级别安全性的服务器的权限。运行用户级别安全性的服务器会忽略此成员。此成员可以是以下一个或多个值。对 NetShareSetInfo 函数的调用将忽略此成员。

请注意，Windows 不支持共享级别安全性。

值	含义
ACCESS_READ	从资源读取数据的权限，默认情况下执行资源的权限。
ACCESS_WRITE	将数据写入资源的权限。
ACCESS_CREATE	创建资源 (实例的权限，例如文件) ;创建资源时，可以将数据写入资源。
ACCESS_EXEC	执行资源的权限。
ACCESS_DELETE	删除资源的权限。
ACCESS_ATRIB	修改资源属性的权限 (，例如上次修改文件的日期和时间) 。
ACCESS_PERM	修改 (用户或应用程序分配给资源的读取、写入、创建、执行和删除) 的权限。
ACCESS_ALL	读取、写入、创建、执行和删除资源以及修改其属性和权限的权限。

shi2_max_uses

指定一个 DWORD 值，该值指示共享资源可以容纳的最大并发连接数。如果此成员中指定的值为 –1，则连接数不受限制。

shi2_current_uses

指定一个 DWORD 值，该值指示与资源的当前连接数。对 NetShareSetInfo 函数的调用将忽略此成员。

shi2_path

指向指定共享资源的本地路径的 Unicode 字符串的指针。对于磁盘， shi2_path 是共享的路径。对于打印队列， shi2_path 是共享的打印队列的名称。对 NetShareSetInfo 函数的调用将忽略此成员。

shi2_passwd

指向 Unicode 字符串的指针，该字符串指定当服务器以共享级别安全性运行时共享的密码。如果服务器以用户级别安全性运行，则忽略此成员。 shi2_passwd成员不能超过 SHPWLEN+1 个字节， (包括终止 null 字符) 。对 NetShareSetInfo 函数的调用将忽略此成员。请注意，Windows 不支持共享级别安全性。

要求


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