2.4.40 FileQuotaInformation

This information class is used to query or to set file quota information for a volume. For queries, an optional buffer of FILE_GET_QUOTA_INFORMATION (section 2.4.40.1) data elements is provided by the client to specify the SIDs for which quota information is requested. If the FILE_GET_QUOTA_INFORMATION buffer is not specified, information for all quotas is returned. A buffer of FILE_QUOTA_INFORMATION data elements is returned by the server. For sets, FILE_QUOTA_INFORMATION data elements are populated and sent by the client, as specified in [MS-SMB] section 2.2.7.6.1 and [MS-SMB2] section 3.2.4.15.<143>

When multiple FILE_QUOTA_INFORMATION data elements are present in the buffer, each MUST be aligned on an 8-byte boundary. Any bytes inserted for alignment SHOULD be set to zero, and the receiver MUST ignore them. No padding is required following the last data element.

A FILE_QUOTA_INFORMATION data element is as follows.

NextEntryOffset (4 bytes):  A 32-bit unsigned integer that contains the byte offset from the beginning of this entry, at which the next FILE_QUOTA_INFORMATION entry is located, if multiple entries are present in a buffer. This member MUST be zero if no other entries follow this one. An implementation MUST use this value to determine the location of the next entry (if multiple entries are present in a buffer).

SidLength (4 bytes):  A 32-bit unsigned integer that contains the length, in bytes, of the Sid data element.

ChangeTime (8 bytes): The last time that the quota was changed; see section 2.1.1. This value MUST be greater than or equal to 0x0000000000000000. When setting quota information, the server MUST ignore the value of this field.

QuotaUsed (8 bytes): A 64-bit signed integer that contains the amount of quota used by this user, in bytes. This value MUST be greater than or equal to 0x0000000000000000. When setting quota information, the server MUST ignore the value of this field.

QuotaThreshold (8 bytes):  A 64-bit signed integer that contains the disk quota warning threshold, in bytes, on this volume for this user. This field MUST be set to a 64-bit integer value greater than or equal to 0 to set a quota warning threshold for this user on this volume. If this field is set to -1 there is no quota warning threshold for this user.

QuotaLimit (8 bytes): A 64-bit signed integer that contains the disk quota limit, in bytes, on this volume for this user. This field MUST be set to a 64-bit integer value greater than or equal to zero to set a disk quota limit for this user on this volume, to -1 to specify that no quota limit is set for this user, or to -2 to delete the quota entry for the user.

Sid (variable): Security identifier (SID) for this user.

This operation returns a status code as specified in section 2.2. Upon success, the status code returned by the function that processes this file information class is STATUS_SUCCESS. The most common error codes are listed in the following table.