3.3.1.2 Per Share

  • Article

Server.Share: A share that is available on the server. The following ADM elements are maintained for each share offered by a server:

Server.Share.LocalPath: A path that describes the local resource that is being shared. This MUST be a store that either provides named pipe functionality, or a device or a volume that offers storage and/or retrieval of files. In the case of the latter, it can be a device that accepts a file and then processes it in some format, such as a printer.<214>

Server.Share.OptionalSupport: The optional support bits for the share. See the description of the OptionalSupport field in the SMB_COM_TREE_CONNECT_ANDX Response (section 2.2.4.55.2) for information on the defined bit flags.

Server.Share.ServerName: A local server name to which a shared resource attaches.

Server.Share.Type: The type of share. The Service field in the SMB_COM_TREE_CONNECT_ANDX Response (section 2.2.4.55.2) is matched against this element. The list of possible values is as follows:

  • Disk -- Share is a disk share.

  • Named Pipe -- Share is a named pipe.

  • Printer -- Share is a printer share.

  • Comm -- Share is a serial communications device.

Server.Share.Name: A name for the shared resource on this server.

Share.FileSecurity: An authorization policy of type SECURITY_DESCRIPTOR ([MS-DTYP] section 2.4.6), such as an access control list that describes what actions users that connect to this share are allowed to perform on the shared resource.<215> If the value of this ADM element is NULL, no access limits are enforced.

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

Server.Share.MaxUses: The value indicates the maximum number of concurrent connections that the shared resource can accommodate.

Server.Share.CurrentUses: The value indicates the number of current tree connects to the shared resource.