DiskQuotaControl オブジェクト

  • [アーティクル]

管理者がボリュームのディスク クォータ プロパティを管理できるようにします。 NTFS ファイル システムを使用すると、管理者は、指定されたディスク領域 ( クォータ制限) を各ユーザーに割り当てることで、共有ボリュームのディスク使用量を管理できます。 このオブジェクトを使用して、すべての新しいユーザーに自動的に割り当てられる既定のクォータ制限を設定できます。

メンバー

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

イベント

DiskQuotaControl オブジェクトには、これらのイベントがあります。

Event 説明
OnUserNameChanged DIDiskQuotaUser オブジェクトの名前情報が解決されたときに発生します。

 

メソッド

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

メソッド 説明
Adduser 既定以外のディスク クォータを新しいユーザーに割り当てます。
DeleteUser ボリュームからユーザーを削除します。
FindUser ボリュームのクォータ ファイルで、ユーザーのエントリを名前で検索します。
GiveUserNameResolutionPriority 名前解決のために、指定したユーザー オブジェクトを行の次に配置します。
初期化する 指定したボリュームを開き、そのクォータ制御オブジェクトを初期化します。
InvalidateSidNameCache セキュリティ ID ユーザー名キャッシュを無効にします。
ShutdownNameResolution ユーザー名解決スレッドをシャットダウンします。
TranslateLogonNameToSID ログオン名を、対応するユーザー セキュリティ ID に文字列形式で変換します。

 

プロパティ

DiskQuotaControl オブジェクトには、次のプロパティがあります。

プロパティ アクセスの種類 説明
DefaultQuotaLimit
 読み取り/書き込み
 既定のクォータ制限を設定または取得します。
DefaultQuotaLimitText
 読み取り専用
 既定のクォータ制限をテキスト文字列として取得します。
DefaultQuotaThreshold
 読み取り/書き込み
 既定のクォータしきい値を設定または取得します。
DefaultQuotaThresholdText
 読み取り専用
 既定のクォータしきい値をテキスト文字列として取得します。
LogQuotaLimit
 読み取り/書き込み
 ユーザーが割り当てられたクォータ制限を超えたときにシステム イベント ログ エントリを作成するかどうかを示すブール値を設定または取得します。
LogQuotaThreshold
 読み取り/書き込み
 ユーザーが割り当てられたクォータしきい値を超えたときにシステム イベント ログ エントリを作成するかどうかを示すブール値を設定または取得します。
QuotaFileIncomplete
 読み取り専用
 ボリュームのクォータ ファイルが完了したかどうかを示すブール値を取得します。
QuotaFileRebuilding
 読み取り専用
 ボリュームのクォータ ファイルが現在再構築されているかどうかを示すブール値を取得します。
QuotaState
 読み取り/書き込み
 ボリュームのディスク クォータの状態を設定または取得します。
UserNameResolution
 読み取り/書き込み
 ユーザー SID をユーザー名に解決する方法を制御する値を設定または取得します。

 

注釈

管理者は DiskQuotaControl オブジェクトを使用して、次のような多くのタスクを実行できます。

  • ボリュームのディスク クォータ システムの有効化と無効化。
  • ボリューム上のクォータ システムの状態の取得。
  • クォータ制限を超えたユーザーに対してディスク領域を拒否する。
  • 新しいユーザーに割り当てられる既定の警告しきい値とクォータ制限値を指定します。
  • ユーザーの追加と削除。

DiskQuotaControl オブジェクトを使用すると、クォータ制限などのプロパティのボリュームのグローバル既定値を設定できます。 ただし、各ユーザーは、個々のクォータ設定を指定するために使用できる DIDiskQuotaUser オブジェクトで表されます。

ユーザーの DIDiskQuotaUser オブジェクトを取得するには、いくつかの方法があります。

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

このオブジェクトは、スクリプトと Microsoft Visual Basic ベースのアプリケーションで IDiskQuotaControl インターフェイスの重要な機能を使用できるようにします。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
[DLL]
Shell32.dll (バージョン 5.0 以降)

こちらもご覧ください

シェル オブジェクト