Objek DIDiskQuotaUser

Artikel
06/13/2023

Memungkinkan klien mengelola pengaturan kuota disk global volume NTFS. Objek ini membuat fungsionalitas penting antarmuka DIDiskQuotaUser tersedia untuk pembuatan skrip dan aplikasi berbasis Microsoft Visual Basic.

Anggota

Objek DIDiskQuotaUser memiliki jenis anggota ini:

Metode
Properti

Metode

Objek DIDiskQuotaUser memiliki metode ini.

Metode	Deskripsi
Membatalkan	Menghapus informasi pengguna yang di-cache objek.

Properti

Objek DIDiskQuotaUser memiliki properti ini.

Properti	Jenis akses	Deskripsi
AccountContainerName	Baca-saja	Mendapatkan nama kontainer akun pengguna.
AccountStatus	Baca-saja	Mendapatkan status akun pengguna.
DisplayName	Baca-saja	Mendapatkan nama tampilan pengguna.
ID	Baca-saja	Mendapatkan ID yang secara unik mengidentifikasi pengguna.
LogonName	Baca-saja	Mendapatkan nama akun masuk pengguna.
QuotaLimit	Baca/Tulis	Mengatur atau mendapatkan batas kuota pengguna saat ini.
QuotaLimitText	Baca-saja	Mendapatkan batas kuota pengguna saat ini sebagai string teks.
QuotaThreshold	Baca/Tulis	Mengatur atau mendapatkan ambang peringatan pengguna, dalam byte.
QuotaThresholdText	Baca-saja	Mendapatkan ambang peringatan pengguna sebagai string teks.
Kuota Yang Digunakan	Baca-saja	Mendapatkan penggunaan disk pengguna saat ini, dalam byte.
QuotaUsedText	Baca-saja	Mendapatkan penggunaan disk pengguna saat ini sebagai string teks.

Keterangan

Setiap pengguna pada volume yang dikelola oleh objek DiskQuotaControl memiliki objek DIDiskQuotaUser yang terkait dengannya. Objek ini memungkinkan klien mengelola pengaturan pengguna individual. Ada beberapa cara untuk mendapatkan objek DIDiskQuotaUser pengguna:

Objek DIDiskQuotaUser untuk semua pengguna dengan kuota pada volume diekspos sebagai koleksi dan dapat dijumlahkan. Diskusi tentang cara menghitung objek DIDiskQuotaUser ditemukan di bawah ini.
Saat Anda menambahkan pengguna baru, metode AddUser mengembalikan objek DIDiskQuotaUser pengguna.
Jika Anda memiliki nama pengguna, metode FindUser mengembalikan objek DIDiskQuotaUser pengguna.

Menghitung Pengguna Kuota Disk

Objek DIDiskQuotaUser untuk semua pengguna dengan kuota pada volume diekspos sebagai koleksi. Objek DiskQuotaControl mengekspor metode enumerator standar yang memungkinkan Anda menghitung pengumpulan objek DIDiskQuotaUser . Prosedur berikut ini menggambarkan cara melakukan enumerasi dengan Microsoft JScript (kompatibel dengan spesifikasi bahasa ECMA 262). Anda dapat menggunakan prosedur serupa dengan Visual Basic atau Microsoft Visual Basic Scripting Edition (VBScript).

Buat objek DiskQuotaControl baru.
Inisialisasi dengan Inisialisasi.
Buat objek JScript Enumerator baru.
Gunakan untuk perulangan untuk menghitung objek DIDiskQuotaUser . Tidak perlu menetapkan nilai awal. Metode moveNext objek enumerator memberi tahu metode item untuk mengembalikan objek DIDiskQuotaUser berikutnya. Metode atEnd mengembalikan false saat Anda mencapai akhir daftar.
Sesuai kebutuhan, gunakan objek DIDiskQuotaUser yang dikembalikan oleh metode item enumerator untuk mengambil atau mengatur satu atau beberapa properti kuota disk pengguna terkait.

Fragmen kode berikut menggambarkan cara menghitung objek DIDiskQuotaUser dengan JScript. Argumen Volume_Label yang diteruskan ke fungsi EnumUsers adalah nilai string yang berisi label volume seperti "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
     ...
    }
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

Objek Shell