Metode IDiskQuotaControl::AddUserName (dskquota.h)

Artikel
08/23/2023

Menambahkan entri kuota baru pada volume untuk pengguna yang ditentukan. Pengguna diidentifikasi berdasarkan domain dan nama akun.

Sintaks

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Parameter

[in] pszLogonName

String nama masuk akun pengguna.

[in] fNameResolution

Menunjukkan bagaimana informasi akun pengguna akan diperoleh. Informasi kuota volume mengidentifikasi pengguna oleh SID. Informasi akun pengguna (seperti kontainer, nama masuk, dan nama tampilan) harus diperoleh dari pengontrol 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. AddUserName 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. AddUserName kembali 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] ppUser

Penunjuk ke penunjuk antarmuka IDiskQuotaUser ke objek pengguna kuota yang baru dibuat.

Menampilkan nilai

Metode ini mengembalikan kesalahan sistem file atau salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
S_FALSE	Pengguna sudah ada. Tidak ditambahkan.
ERROR_NOT_READY	Objek DiskQuotaControl tidak diinisialisasi.
ERROR_USER_UNKNOWN	Nama pengguna yang ditentukan tidak diketahui.
E_INVALIDARG	Parameter pointer adalah NULL.
E_OUTOFMEMORY	Memori tidak cukup.
E_FAIL	Terjadi kesalahan sistem file yang tidak terduga.
E_UNEXPECTED	Terjadi pengecualian tak terduga.

Keterangan

Sistem file NTFS secara otomatis membuat entri kuota pengguna saat pengguna pertama kali menulis ke volume. Entri yang dibuat secara otomatis diberi nilai ambang batas peringatan default dan batas kuota keras untuk volume. Metode ini memungkinkan Anda membuat entri kuota pengguna sebelum pengguna menulis informasi ke volume. Oleh karena itu, Anda dapat menetapkan nilai batas kuota keras atau ambang peringatan terlebih dahulu yang berbeda dari pengaturan default volume.

Persyaratan


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

Bagikan melalui