(lmshare.h) SHARE_INFO_503 结构

项目
08/24/2023

包含有关共享资源的信息。它与 SHARE_INFO_502 结构相同，只不过它还包含服务器名称。

语法

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

成员

shi503_netname

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

shi503_type

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

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

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

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

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

shi503_remark

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

shi503_permissions

指定一个 DWORD 值，该值指示共享资源对以共享级别安全性运行的服务器的权限。请注意，Windows 不支持共享级别安全性。在运行用户级安全性的服务器上忽略此成员。有关控制对安全对象的访问的详细信息，请参阅访问控制、特权和安全对象。

对 NetShareSetInfo 函数的调用将忽略此成员。

此成员可以是以下任何值。

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

shi503_max_uses

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

shi503_current_uses

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

shi503_path

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

shi503_passwd

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

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

shi503_servername

指向指定共享资源所在的远程服务器的 DNS 或 NetBIOS 名称的字符串的指针。值“*”表示未配置服务器名称。

shi503_reserved

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

shi503_security_descriptor

指定与此共享关联的 SECURITY_DESCRIPTOR 。

注解

shi503_servername 成员中指定的远程服务器必须已使用 NetServerTransportAddEx 函数绑定到传输协议。在对 NetServerTransportAddEx 的调用中，必须为 level 参数指定 2 或 3，并且 必须在 传输协议的 SERVER_TRANSPORT_INFO_2 结构中指定 SVTI2_SCOPED_NAME 值。

要求


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