Metode DiskQuotaControl.TranslateLogonNameToSID

  • Artikel

Menerjemahkan nama masuk ke ID keamanan pengguna yang sesuai dalam format string.

Sintaks

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

Parameter

nama log masuk

Jenis: String

Nilai string yang menentukan nama masuk pengguna.

Nilai kembali

Mengembalikan ID keamanan pengguna (SID) dalam format string yang sesuai dengan nama masuk yang disediakan. String yang dikembalikan mencakup kurung kurawal penutup standar. Contohnya:

"{S-1-5-21-2127521184-1604012920-1887927527-19009}"

Keterangan

String SID yang dikembalikan dapat diteruskan ke metode FindUser sebagai pengganti nama masuk.

Ketika panggilan ke metode FindUser( logonname) gagal, itu bisa disebabkan oleh ketidakcocokan antara formulir (misalnya, Kompatibel dengan Manajer Akun Keamanan [SAM] dan Nama Prinsipal Pengguna [UPN]) dari nama masuk yang disediakan dan formulir yang disimpan dalam cache nama SID. Dalam kasus seperti itu, nama masuk dapat dikonversi ke SID dan panggilan ke FindUser diulang. FindUser mengenali string SID dan akan melewati pencarian cache nama SID. Kode Microsoft Visual Basic Scripting Edition (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

Terjemahan nama-ke-SID bisa menjadi proses yang lambat jika dibandingkan dengan pencarian di cache nama SID. Oleh karena itu, disarankan agar FindUser terlebih dahulu dipanggil dengan nama masuk. Contoh di atas menggunakan teknik ini.

Persyaratan

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

Lihat juga

Objek DiskQuotaControl