Metode DiskQuotaControl.FindUser

  • Artikel

Menemukan entri pengguna, berdasarkan nama, dalam file kuota volume.

Sintaks

DiskQuotaControl.FindUser(
  sLogonName
)

Parameter

sLogonName

Jenis: String

Nilai string yang berisi nama masuk pengguna.

Nilai kembali

Mengembalikan ekspresi objek yang mengevaluasi ke objek DIDiskQuotaUser pengguna.

Keterangan

Metode ini mengembalikan objek DIDiskQuotaUser meskipun tidak ada entri untuk pengguna dalam file kuota. Objek pengguna yang dikembalikan memiliki ambang batas peringatan dan batas kuota keras yang diatur ke nilai default volume.

String yang dikembalikan dari TranslateLogonNameToSID dapat diteruskan sebagai pengganti parameter sLogonName . Ketika FindUser menerima string SID, ia menggunakan SID yang sesuai untuk pencarian langsung rekaman kuota pengguna pada volume. Ini melewati cache nama SID. Dalam kasus di mana FindUser gagal karena ketidakcocokan dalam format (misalnya, kompatibel DENGAN SAM dan UPN) dari nama masuk yang disediakan dan nama masuk di-cache, nama masuk dapat diterjemahkan ke string SID menggunakan TranslateLogonNameToSID kemudian diteruskan lagi ke FindUser. Kode VBScript berikut mengilustrasikan teknik ini.

Function Find(dqc, name)
    On Error Resume Next
    SET Find = dqc.FindUser(name)

    If Err.Number <> 0 Then
        Err.Clear
        SET Find = dqc.FindUser(dqc.TranslateLogonNameToSID(name))
    End If    

End Function

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
 Windows 2000 Server [hanya aplikasi desktop]
DLL
Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

Objek DiskQuotaControl