FILE_QUOTA_INFORMATION 結構 (ntifs.h)

FILE_QUOTA_INFORMATION結構可用來查詢或設定目錄中每個檔案的每個使用者配額資訊。

語法

typedef struct _FILE_QUOTA_INFORMATION {
  ULONG         NextEntryOffset;
  ULONG         SidLength;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER QuotaUsed;
  LARGE_INTEGER QuotaThreshold;
  LARGE_INTEGER QuotaLimit;
  SID           Sid;
} FILE_QUOTA_INFORMATION, *PFILE_QUOTA_INFORMATION;

成員

NextEntryOffset

清單中下一個配額專案的位移,以位元組為單位。 如果目前項目之後沒有其他專案,則此成員為零。

SidLength

Sid 成員的長度,以位元組為單位。

ChangeTime

上次變更此配額項目的時間。

QuotaUsed

使用者目前正在使用此磁碟區上的磁碟空間量。

QuotaThreshold

此磁碟區上可讓使用者在不觸發事件的情況下使用的最大磁碟空間掛接。 如需詳細資訊,請參閱 FILE_FS_CONTROL_INFORMATION

QuotaLimit

此磁碟區上可供使用者使用的最大磁碟空間量。

Sid

使用者的安全性標識碼 (SID) 。

備註

查詢此資訊不需要任何特定的訪問許可權。 若要執行此查詢,請使用主要函式程式碼建立 IRP IRP_MJ_QUERY_QUOTA。

FILE_WRITE_DATA必須存取磁碟區才能設定這項資訊。 若要執行這項作業,請建立具有主要函式程式代碼的 IRP IRP_MJ_SET_QUOTA。

若要檢查包含FILE_QUOTA_INFORMATION結構的緩衝區有效性,請呼叫 IoCheckQuotaBufferValidity

在32位平臺上,此結構必須對齊LONG (4位元組) 界限。 如果緩衝區包含這兩個以上的結構,則每個專案中的 NextEntryOffset 值,但最後一個值落在 4 位元組的界限上。

在 64 位平臺上,此結構必須對齊 LONGLONG (8 位元組) 界限。 如果緩衝區包含兩個或多個這些結構,則每個專案中的 NextEntryOffset 值會落在 8 位元組界限上,但最後一個專案除外。

規格需求

需求
標頭 ntifs.h (包含 Ntifs.h、Fltkernel.h)

另請參閱

FILE_FS_CONTROL_INFORMATION

IRP_MJ_QUERY_QUOTA

IRP_MJ_SET_QUOTA

IoCheckQuotaBufferValidity