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 物件