DIDiskQuotaUser 物件

允許用戶端管理 NTFS 磁片區的全域磁片配額設定。 此物件讓 DIDiskQuotaUser 介面的基本功能可供腳本和 Microsoft Visual Basic 應用程式使用。

成員

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

方法

DIDiskQuotaUser物件具有這些方法。

方法 描述
Invalidate 清除物件的快取使用者資訊。

 

屬性

DIDiskQuotaUser物件具有這些屬性。

屬性 存取類型 描述
AccountContainerName
唯讀
取得使用者帳戶容器的名稱。
AccountStatus
唯讀
取得使用者帳戶的狀態。
DisplayName
唯讀
取得使用者的顯示名稱。
識別碼
唯讀
取得可唯一識別使用者的識別碼。
LogonName
唯讀
取得使用者的登入帳戶名稱。
QuotaLimit
讀取/寫入
設定或取得使用者的目前 配額限制。
QuotaLimitText
唯讀
取得使用者的目前 配額限制 做為文字字串。
QuotaThreshold
讀取/寫入
設定或取得使用者的警告臨界值,以位元組為單位。
QuotaThresholdText
唯讀
取得使用者的警告臨界值做為文字字串。
QuotaUsed
唯讀
取得使用者的目前磁片使用量,以位元組為單位。
QuotaUsedText
唯讀
取得使用者的目前磁片使用量做為文字字串。

 

備註

DiskQuotaControl物件所管理磁片區上的每個使用者都有與其相關聯的DIDiskQuotaUser物件。 此物件可讓用戶端管理個別使用者的設定。 有數種方式可以取得使用者的 DIDiskQuotaUser 物件:

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

列舉磁片配額使用者

磁片區上具有配額的所有使用者 的 DIDiskQuotaUser 物件會公開為集合。 DiskQuotaControl物件會匯出標準列舉值方法,讓您列舉DIDiskQuotaUser物件的集合。 下列程式說明如何使用與 ECMA 262 語言規格) 相容的 Microsoft JScript (來執行列舉。 您可以使用類似的程式搭配 Visual Basic 或 Microsoft Visual Basic Scripting Edition (VBScript) 。

  1. 建立新的 DiskQuotaControl 物件。
  2. 使用 Initialize 將其初始化。
  3. 建立新的 JScript 列舉值 物件。
  4. 使用 for 迴圈列舉 DIDiskQuotaUser 物件。 不需要設定起始值。 列舉值物件的 moveNext 方法會通知 專案 方法傳回下一個 DIDiskQuotaUser 物件。 當您到達清單結尾時, atEnd 方法會傳回 false 。
  5. 視需要,使用列舉值專案方法所傳回的DIDiskQuotaUser物件來擷取或設定一或多個相關聯的使用者磁片配額屬性。

下列程式碼片段說明如何使用 JScript 列舉 DIDiskQuotaUser 物件。 傳遞至EnumUsers函式的 Volume_Label引數是包含磁片區標籤的字串值,例如 「C:\\」。

function EnumUsers(Volume_Label)
{
    var Volume;
    var QuotaUsers;
    var QuotaUser;

    Volume = new ActiveXObject("Microsoft.DiskQuota.1");
    Volume.Initialize(Volume_Label, 1);

    QuotaUsers = new Enumerator(Volume);
    for (;!Users.atEnd(); Users.moveNext())
    {
       QuotaUser = QuotaUsers.item();

     //Use the QuotaUser object to retrieve or set one or more
     //of the user's disk quota properties
     ...
    }
}

規格需求

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

另請參閱

Shell 物件