SHARE_INFO_502 结构 (lmshare.h)

项目
03/05/2024

包含有关共享资源的信息，包括资源的名称、类型和权限、连接数以及其他相关信息。

语法

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

成员

shi502_netname

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

shi502_type

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

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

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

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

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

shi502_remark

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

shi502_permissions

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

请注意，Windows 不支持共享级别安全性。有关控制对安全对象的访问的详细信息，请参阅访问控制、特权和安全对象。

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

shi502_max_uses

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

shi502_current_uses

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

shi502_path

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

shi502_passwd

指向 Unicode 字符串的指针，该字符串指定当服务器以共享级别安全) 运行时共享的密码 (。如果服务器以用户级别安全性运行，则忽略此成员。请注意，Windows 不支持共享级别安全性。

此成员不能超过 SHPWLEN+1 个字节， (包括终止 null 字符) 。对 NetShareSetInfo 函数的调用将忽略此成员。

shi502_reserved

保留;必须为零。对 NetShareSetInfo 函数的调用将忽略此成员。

shi502_security_descriptor

指定与此共享关联的 SECURITY_DESCRIPTOR 。

要求

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