DIDiskQuotaUser オブジェクト

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

メンバー

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

メソッド

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

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

プロパティ

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

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

解説

Diskquotacontrolオブジェクトによって管理されるボリューム上の各ユーザーには、関連付けられたオブジェクトが関連付けられています。 このオブジェクトを使用すると、クライアントは個々のユーザーの設定を管理できます。 ユーザーの 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 オブジェクトを返すように 項目 メソッドに通知します。 Atend メソッドは、リストの末尾に近づいたときに false を返します。
  5. 必要に応じて、列挙子の item メソッドによって返された DIDiskQuotaUser オブジェクトを使用して、関連付けられているユーザーのディスククォータプロパティを取得または設定します。

次のコードフラグメントは、JScript で DIDiskQuotaUser オブジェクトを列挙する方法を示しています。 Enumusers 関数に渡される ボリューム _ ラベル 引数は、"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 オブジェクト