Metode IDiskQuotaControl::AddUserSid (dskquota.h)
Menambahkan entri kuota baru pada volume untuk pengguna yang ditentukan. Pengguna diidentifikasi oleh pengidentifikasi keamanan (SID).
Sintaks
HRESULT AddUserSid(
[in] PSID pUserSid,
[in] DWORD fNameResolution,
[out] PDISKQUOTA_USER *ppUser
);
Parameter
[in] pUserSid
SID pengguna.
[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. AddUserSid 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. AddUserSid 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.
Mengembalikan nilai
Metode ini mengembalikan kesalahan sistem file atau salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil. |
|
Pemanggil memiliki hak akses yang tidak mencukup. |
|
SDI yang ditentukan tidak diketahui. |
|
Objek DiskQuotaControl tidak diinisialisasi. |
|
Parameter pUserSid atau ppUser adalah NULL. |
|
Memori tidak cukup. |
|
Terjadi kesalahan sistem file yang tidak terduga. |
|
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
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 |