DIDiskQuotaUser オブジェクト

クライアントが NTFS ボリュームのグローバル ディスク クォータ設定を管理できるようにします。 このオブジェクトを使用すると、 DIDiskQuotaUser インターフェイスの重要な機能をスクリプトと Microsoft Visual Basic ベースのアプリケーションで使用できるようになります。

メンバー

DIDiskQuotaUser オブジェクトには、次の種類のメンバーがあります。

• メソッド
• プロパティ

メソッド

DIDiskQuotaUser オブジェクトには、これらのメソッドがあります。

メソッド	説明
Invalidate	オブジェクトのキャッシュされたユーザー情報をクリアします。

 

プロパティ

DIDiskQuotaUser オブジェクトには、これらのプロパティがあります。

プロパティ	アクセスの種類	説明
AccountContainerName	読み取り専用	ユーザーのアカウント コンテナーの名前を取得します。
AccountStatus	読み取り専用	ユーザーのアカウントの状態を取得します。
DisplayName	読み取り専用	ユーザーの表示名を取得します。
id	読み取り専用	ユーザーを一意に識別する ID を取得します。
LogonName	読み取り専用	ユーザーのログオン アカウント名を取得します。
QuotaLimit	読み取り/書き込み	ユーザーの現在の クォータ制限を設定または取得します。
QuotaLimitText	読み取り専用	ユーザーの現在の クォータ制限 をテキスト文字列として取得します。
QuotaThreshold	読み取り/書き込み	ユーザーの警告しきい値をバイト単位で設定または取得します。
QuotaThresholdText	読み取り専用	ユーザーの警告しきい値をテキスト文字列として取得します。
QuotaUsed	読み取り専用	ユーザーの現在のディスク使用量をバイト単位で取得します。
QuotaUsedText	読み取り専用	ユーザーの現在のディスク使用量をテキスト文字列として取得します。

 

解説

DiskQuotaControl オブジェクトによって管理されるボリューム上の各ユーザーには、DIDiskQuotaUser オブジェクトが関連付けられています。 このオブジェクトを使用すると、クライアントは個々のユーザーの設定を管理できます。 ユーザーの DIDiskQuotaUser オブジェクトを取得するには、いくつかの方法があります。

• ボリューム上のクォータを持つすべてのユーザーの DIDiskQuotaUser オブジェクトはコレクションとして公開され、列挙できます。 DIDiskQuotaUser オブジェクトを列挙する方法の説明を以下に示します。
• 新しいユーザーを追加すると、 AddUser メソッドはユーザーの DIDiskQuotaUser オブジェクトを 返します。
• ユーザーの名前がある場合、 FindUser メソッドはユーザーの DIDiskQuotaUser オブジェクトを 返します。

ディスク クォータ ユーザーの列挙

ボリュームのクォータを持つすべてのユーザーの DIDiskQuotaUser オブジェクトは、コレクションとして公開されます。 DiskQuotaControl オブジェクトは、DIDiskQuotaUser オブジェクトのコレクションを列挙できる標準の列挙子メソッドをエクスポートします。 次の手順は、Microsoft JScript (ECMA 262 言語仕様と互換性があります) を使用して列挙を実行する方法を示しています。 同様の手順は、Visual Basic または Microsoft Visual Basic Scripting Edition (VBScript) で使用できます。

1. 新しい DiskQuotaControl オブジェクトを作成します。
2. Initialize を使用して 初期化します。
3. 新しい JScript 列挙子 オブジェクトを作成します。
4. for ループを使用して DIDiskQuotaUser オブジェクトを列挙します。 開始値を設定する必要はありません。 列挙子オブジェクトの moveNext メソッドは 、次 の DIDiskQuotaUser オブジェクトを返すように item メソッドに通知します。 atEnd メソッドは、リストの末尾に達すると false を返します。
5. 必要に応じて、列挙子の item メソッドによって返される DIDiskQuotaUser オブジェクトを使用して、関連付けられているユーザーのディスク クォータ プロパティを 1 つ以上取得または設定します。

次のコード フラグメントは、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 以降)

関連項目

シェル オブジェクト