Metode IDiskQuotaControl::FindUserSid (dskquota.h)
Menemukan entri pengguna tertentu dalam informasi kuota volume. Pengidentifikasi keamanan (SID) pengguna digunakan sebagai kunci pencarian.
Sintaks
HRESULT FindUserSid(
[in] PSID pUserSid,
[in] DWORD fNameResolution,
[out] PDISKQUOTA_USER *ppUser
);
Parameter
[in] pUserSid
Penunjuk ke 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. FindUserSid 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. |
|
Mengatasi informasi akun pengguna secara sinkron. FindUserSid kembali ketika informasi telah diselesaikan. Jika informasi ada dalam cache SID kuota disk, informasi tersebut akan segera dikembalikan. Jika tidak, metode harus menemukan informasi. Ini bisa memakan waktu beberapa detik. |
[out] ppUser
Penunjuk untuk menerima penunjuk antarmuka IDiskQuotaUser ke objek pengguna kuota.
Menampilkan nilai
Metode ini mengembalikan kesalahan sistem file atau salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil. |
|
Pemanggil memiliki hak akses yang tidak mencukup. |
|
Objek DiskQuotaControl tidak diinisialisasi. |
|
SID untuk pengguna tidak valid. |
|
Parameter pUserSid atau ppUser adalah NULL. |
|
Memori tidak cukup. |
|
Terjadi kesalahan sistem file yang tidak terduga. |
|
Terjadi pengecualian tak terduga. |
Keterangan
Metode ini akan mengembalikan objek pengguna meskipun tidak ada catatan kuota untuk pengguna dalam file kuota. Ini konsisten dengan gagasan penambahan pengguna otomatis dan pengaturan kuota default. Jika saat ini tidak ada entri kuota untuk pengguna yang diminta, dan pengguna akan ditambahkan ke file kuota jika dia meminta ruang disk, objek pengguna yang dikembalikan akan memiliki ambang batas peringatan dan batas kuota keras yang sama dengan 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 |