DiskQuotaControl 物件

可讓系統管理員管理磁片區的磁片配額屬性。 NTFS 檔案系統可讓系統管理員藉由將指定的磁碟空間量或 配額限制配置給每個使用者,來管理共用磁片區上的磁片使用量。 您可以使用此物件來設定會自動指派給所有新使用者的預設配額限制。

成員

DiskQuotaControl物件具有下列類型的成員:

事件

DiskQuotaControl物件具有這些事件。

事件 描述
OnUserNameChanged 發生于 已解析 DIDiskQuotaUser 物件的名稱資訊時。

 

方法

DiskQuotaControl物件具有這些方法。

方法 Description
AddUser 將非預設磁片配額指派給新使用者。
DeleteUser 從磁片區中刪除使用者。
FindUser 在磁片區的配額檔案中,依名稱尋找使用者的專案。
GiveUserNameResolutionPriority 將指定的使用者物件放在行中,以進行名稱解析。
初始 化 開啟指定的磁片區,並初始化其配額控制物件。
InvalidateSidNameCache 使安全性識別碼使用者名稱快取失效。
ShutdownNameResolution 關閉使用者名稱解析執行緒。
TranslateLogonNameToSID 以字串格式將登入名稱轉譯為對應的使用者安全性識別碼。

 

屬性

DiskQuotaControl物件具有這些屬性。

屬性 存取類型 Description
DefaultQuotaLimit
讀取/寫入
設定或取得預設配額限制。
DefaultQuotaLimitText
唯讀
取得以文字字串表示的預設配額限制。
DefaultQuotaThreshold
讀取/寫入
設定或取得預設配額閾值。
DefaultQuotaThresholdText
唯讀
取得預設配額閾值做為文字字串。
LogQuotaLimit
讀取/寫入
設定或取得 Boolean 值,指出當使用者超過其指派的配額限制時,是否要進行系統事件記錄專案。
LogQuotaThreshold
讀取/寫入
設定或取得布林值,指出當使用者超過其指派的配額閾值時,是否要進行系統事件記錄專案。
QuotaFileIncomplete
唯讀
取得布林值,指出磁片區的配額檔案是否已完成。
QuotaFileRebuilding
唯讀
取得布林值,指出磁片區的配額檔案目前是否正在重建。
QuotaState
讀取/寫入
設定或取得磁片區磁片配額的狀態。
UserNameResolution
讀取/寫入
設定或取得值,控制如何將使用者 SID 解析為使用者名稱。

 

備註

系統管理員可以使用 DiskQuotaControl 物件來執行許多工作,包括下列各項:

  • 啟用和停用磁片區的磁片配額系統。
  • 取得磁片區上配額系統的狀態。
  • 拒絕使用者的磁碟空間超過其配額限制。
  • 指定將指派給新使用者的預設警告臨界值和配額限制值。
  • 新增和移除使用者。

DiskQuotaControl物件可讓您為磁片區設定全域預設值,例如配額限制。 不過,每個使用者都是以 DIDiskQuotaUser 物件表示,可用來指定個別配額設定。

有數種方式可以取得使用者的 DIDiskQuotaUser 物件:

  • 磁片區上具有配額之所有使用者的 DIDiskQuotaUser 物件會公開為集合,而且可以列舉。 如需如何列舉DIDiskQuotaUser物件的討論,請參閱DIDiskQuotaUser一節中的列舉磁片配額使用者
  • 當您新增使用者時, AddUser 方法會傳回使用者的 DIDiskQuotaUser 物件。
  • 如果您有使用者的名稱, FindUser 方法會傳回使用者的 DIDiskQuotaUser 物件。

此物件讓 IDiskQuotaControl 介面的基本功能可供腳本和 Microsoft Visual Basic 應用程式使用。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
DLL
Shell32.dll (5.0 版或更新版本)

另請參閱

Shell 物件