2.2.4.27 SHARE_INFO_503_I

  • Article

The SHARE_INFO_503_I structure contains information about the shared resource, including the name of the resource, type, and permissions, the number of connections, and other pertinent information.

 typedef struct _SHARE_INFO_503_I {
   [string] WCHAR* shi503_netname;
   DWORD shi503_type;
   [string] WCHAR* shi503_remark;
   DWORD shi503_permissions;
   DWORD shi503_max_uses;
   DWORD shi503_current_uses;
   [string] WCHAR* shi503_path;
   [string] WCHAR* shi503_passwd;
   [string] WCHAR* shi503_servername;
   DWORD shi503_reserved;
   [size_is(shi503_reserved)] PUCHAR shi503_security_descriptor;
 } SHARE_INFO_503_I,
  *PSHARE_INFO_503_I,
  *LPSHARE_INFO_503_I;

shi503_netname: A pointer to a null-terminated Unicode UTF-16 string that specifies the name of a shared resource. The server MUST ignore this member when processing the NetrShareSetInfo (section 3.1.4.11) method.

shi503_type: Specifies a DWORD value that indicates the type of share. The server MUST ignore this member when processing the NetrShareSetInfo method. Otherwise, it MUST be one of the values listed in section 2.2.2.4.

shi503_remark: A pointer to a null-terminated Unicode UTF-16 string that specifies an optional comment about the shared resource.

shi503_permissions: This field is not used. The server MUST ignore the value of this parameter on receipt.

shi503_max_uses: Specifies a DWORD value that indicates the maximum number of concurrent connections that the shared resource can accommodate. If the value is 0xFFFFFFFF, the maximum number of connections MUST be unlimited.

shi503_current_uses: Specifies a DWORD value that indicates the number of current connections to the resource. The server MUST ignore this member on receipt.

shi503_path: A pointer to a null-terminated Unicode UTF-16 string that contains the local path for the shared resource. For disks, it is the path being shared. For print queues, it is the name of the print queue being shared. The server MUST ignore this member when processing the NetrShareSetInfo method.

shi503_passwd: This field is not used. The client MUST send a NULL (zero-length) string, and the server MUST ignore the value of this parameter on receipt.

shi503_servername: A pointer to a string that specifies the DNS or NetBIOS name of the server on which the shared resource resides. It SHOULD be either "*" or the string matching one of the server names. Otherwise, the default server name will be used in <shi503_netname, default server name> to locate a scoped share as specified in section 2.2.4.102. A value of "*" indicates that there is no configured server name.

shi503_reserved: The length of the security descriptor passed in the shi503_security_descriptor member.

shi503_security_descriptor: Specifies the SECURITY_DESCRIPTOR, as described in [MS-DTYP] section 2.4.6, that is associated with this share.