3.3.1.6 Per Share

  • Article

The server implements the following:

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

  • Share.ServerName: The NetBIOS, fully qualified domain name (FQDN), or textual IPv4 or IPv6 address that the share is associated with. For more information, see [MS-SRVS] section 3.1.1.7.

  • 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 that offers storage and/or retrieval of files. In the case of the latter, it MAY<204> be a device that accepts a file and then processes it in some format, such as a printer.

  • Share.ConnectSecurity: An authorization policy such as an access control list that describes which users are allowed to connect to this share.

  • Share.FileSecurity: An authorization policy such as an access control list that describes what actions users that connect to this share are allowed to perform on the shared resource.<205>

  • Share.CscFlags: The configured offline caching policy for this share. This value MUST be manual caching, automatic caching of files, automatic caching of files and programs, or no offline caching. For more information, see section 2.2.10. For more information about offline caching, see [OFFLINE].

  • Share.IsDfs: A Boolean that, if set, indicates that this share is configured for DFS. For more information, see [MSDFS].

  • Share.DoAccessBasedDirectoryEnumeration: A Boolean that, if set, indicates that the results of directory enumerations on this share MUST be trimmed to include only the files and directories that the calling user has the right to access.

  • Share.AllowNamespaceCaching: A Boolean that, if set, indicates that clients are allowed to cache directory enumeration results for better performance.<206>

  • Share.ForceSharedDelete: A Boolean that, if set, indicates that all opens on this share MUST include FILE_SHARE_DELETE in the sharing access.

  • Share.RestrictExclusiveOpens: A Boolean that, if set, indicates that users who request read-only access to a file are not allowed to deny other readers.

  • Share.Type: The value indicates the type of share. It MUST be one of the values that are listed in [MS-SRVS] section 2.2.2.4.

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

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

  • Share.CurrentUses: The value indicates the number of current trees connected to the shared resource.

  • Share.ForceLevel2Oplock: A Boolean that, if set, indicates that the server does not issue exclusive caching rights on this share.

  • Share.HashEnabled: A Boolean that, if set, indicates that the share supports hash generation for branch cache retrieval of data.

  • Share.SnapshotList: The list of available snapshots in this Share.

If the server implements the SMB 3.x dialect family, it MUST implement the following:

  • Share.CATimeout: The minimum time, in milliseconds, before closing an unreclaimed persistent handle on a continuously available share.

  • Share.IsCA: A Boolean that, if set, indicates that the share is continuously available.

  • Share.EncryptData: A Boolean that, if set, indicates that the server requires messages for accessing this share to be encrypted, per the conditions specified in section 3.3.5.2.11.

  • Share.SupportsIdentityRemoting: A Boolean that, if set, indicates that the share supports identity remoting by the client.

If the server implements the SMB 3.1.1 dialect, it MUST implement the following:

  • Share.CompressData: A Boolean that, if set, indicates that the server supports compressed read/write messages for accessing this share.

  • Share.IsolatedTransport: A Boolean that, if set, indicates that the share on the server supports isolated transport.