Metode IDiskQuotaControl::FindUserName (dskquota.h)

Artikel
08/23/2023

Menemukan entri tertentu dalam informasi kuota volume. Nama masuk akun pengguna digunakan sebagai kunci pencarian.

Sintaks

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

Parameter

[in] pszLogonName

Penunjuk ke nama masuk akun pengguna.

[out] ppUser

Penunjuk ke penunjuk antarmuka IDiskQuotaUser ke objek pengguna kuota.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
S_OK	Berhasil.
ERROR_ACCESS_DENIED	Pemanggil memiliki hak akses yang tidak mencukup.
ERROR_INVALID_SID	SID untuk pengguna tidak valid.
ERROR_NONE_MAPPED	Tidak ada pemetaan yang tersedia untuk SID.
ERROR_NOT_READY	Objek DiskQuotaControl tidak diinisialisasi.
E_INVALIDARG	Parameter pUserSid atau ppUser adalah NULL.
E_OUTOFMEMORY	Memori tidak cukup.
E_FAIL	Terjadi kesalahan sistem file yang tidak terduga.
E_UNEXPECTED	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

Lihat juga

Antarmuka Manajemen Disk

Kuota Disk

IDiskQuotaControl

Bagikan melalui