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
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	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.
DISKQUOTA_USERNAME_RESOLVE_NONE 0	Jangan atasi informasi akun pengguna.
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	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
S_OK	Berhasil.
ERROR_ACCESS_DENIED	Pemanggil memiliki hak akses yang tidak mencukup.
ERROR_NOT_READY	Objek DiskQuotaControl tidak diinisialisasi.
E_INVALIDARG	Parameter ppEnum adalah NULL.
E_OUTOFMEMORY	Memori tidak cukup.
E_UNEXPECTED	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

Lihat juga

Antarmuka Manajemen Disk

Kuota Disk

IDiskQuotaControl