Metode IDiskQuotaControl::CreateEnumUsers (dskquota.h)
Membuat objek enumerator untuk menghitung pengguna kuota pada volume. Objek yang baru dibuat mengimplementasikan antarmuka IEnumDiskQuotaUsers .
Sintaks
HRESULT CreateEnumUsers(
[in] PSID *rgpUserSids,
[in] DWORD cpSids,
[in] DWORD fNameResolution,
[out] PENUM_DISKQUOTA_USERS *ppEnum
);
Parameter
[in] rgpUserSids
Array penunjuk pengidentifikasi keamanan (SID) yang mewakili objek pengguna yang akan disertakan dalam enumerasi. Jika nilai ini NULL, semua entri pengguna dijumlahkan.
[in] cpSids
Jumlah item dalam array rgpUserSids . Diabaikan jika rgpUserSids adalah NULL.
[in] fNameResolution
Menunjukkan bagaimana informasi akun pengguna akan diperoleh. Informasi kuota volume mengidentifikasi pengguna oleh SID. Informasi akun pengguna (seperti nama domain, nama akun, dan nama lengkap) harus diperoleh dari pengendali domain jaringan, atau komputer lokal jika tidak ada di jaringan. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Atasi informasi akun pengguna secara asinkron. Metode IEnumDiskQuotaUsers::Next segera kembali. Pemanggil harus mengimplementasikan antarmuka IDiskQuotaEvents untuk menerima pemberitahuan saat informasi tersedia. Jika informasi di-cache selama permintaan sebelumnya, pemberitahuan terjadi segera setelah objek dilayankan. Jika tidak, metode ini mendapatkan informasi dari pengendali domain jaringan, lalu memberi tahu IDiskQuotaEvents. |
|
Jangan atasi informasi akun pengguna. |
|
Atasi informasi akun pengguna secara sinkron. Metode IEnumDiskQuotaUsers::Next mengembalikan saat informasi diselesaikan. Jika informasi ada dalam cache SID kuota disk, informasi tersebut akan segera dikembalikan. Jika tidak, metode harus menemukan informasi. Proses ini bisa memakan waktu beberapa detik. |
[out] ppEnum
Penunjuk ke penunjuk ke enumerator IEnumDiskQuotaUsers .
Mengembalikan nilai
Metode ini mengembalikan salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil. |
|
Pemanggil memiliki hak akses yang tidak mencukup. |
|
Objek DiskQuotaControl tidak diinisialisasi. |
|
Parameter ppEnum adalah NULL. |
|
Memori tidak cukup. |
|
Terjadi pengecualian tak terduga. |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | dskquota.h |
DLL | Dskquota.dll |