Antarmuka IADsUser (iads.h)
Antarmuka IADsUser adalah antarmuka ganda yang mewarisi dari IAD. Ini dirancang untuk mewakili dan mengelola akun pengguna akhir di jaringan. Panggil metode antarmuka ini untuk mengakses dan memanipulasi data akun pengguna akhir. Data tersebut mencakup nama pengguna, nomor telepon, jabatan, dan sebagainya. Antarmuka ini mendukung fitur untuk menentukan asosiasi grup pengguna, dan untuk mengatur atau mengubah kata sandi.
Untuk mengikat pengguna domain melalui penyedia WinNT, gunakan nama domain sebagai bagian dari ADsPath, seperti yang ditunjukkan dalam contoh kode berikut.
GetObject("WinNT://MYDOMAIN/jeffsmith,user")
Demikian pula, gunakan nama komputer sebagai bagian dari ADsPath untuk mengikat pengguna lokal.
GetObject("WinNT://MYCOMPUTER/jeffsmith,user")
Di Direktori Aktif, pengguna domain berada di direktori . Contoh kode berikut menunjukkan cara mengikat ke pengguna domain melalui penyedia LDAP.
GetObject("LDAP://CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=Com")
Namun, akun lokal berada di database SAM lokal dan penyedia LDAP tidak berkomunikasi dengan database lokal. Dengan demikian, untuk mengikat pengguna lokal, Anda harus melalui penyedia WinNT seperti yang dijelaskan dalam contoh kode kedua.
Warisan
Antarmuka IADsUser mewarisi dari IDispatch dan IAD. IADsUser juga memiliki jenis anggota ini:
Metode
Antarmuka IADsUser memiliki metode ini.
| IADsUser::ChangePassword Mengubah kata sandi pengguna dari nilai lama yang ditentukan menjadi nilai baru. |
| IADsUser::Groups Mendapatkan koleksi objek grup ADSI tempat pengguna ini berada. |
| IADsUser::SetPassword Mengatur kata sandi pengguna ke nilai yang ditentukan. |
Keterangan
Seperti halnya objek ADSI lainnya, objek kontainer membuat objek akun pengguna Windows. Pertama, ikat ke objek kontainer. Kemudian, panggil metode IADsContainer::Create dan tentukan atribut wajib atau opsional.
Dengan WinNT, Anda tidak perlu menentukan atribut tambahan apa pun saat membuat pengguna. Anda dapat memanggil metode IADsContainer::Create untuk membuat objek pengguna secara langsung.
Dim dom As IADsContainer
Dim usr As IADsUser
On Error GoTo Cleanup
Set dom = GetObject("WinNT://MyDomain")
Set usr = dom.Create("user","jeffsmith")
usr.SetInfo
Cleanup:
If(Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set mach = Nothing
Set usr = Nothing
Dalam hal ini, pengguna domain dibuat dengan nilai default berikut.
| Properti | Nilai |
|---|---|
| Nama Lengkap | Nama Akun SAM (seperti jeffsmith) |
| Kata sandi | Kosong |
| Pengguna Harus Mengubah Kata Sandi | TRUE |
| Pengguna Tidak Dapat Mengubah Kata Sandi | FALSE |
| Kata sandi Tidak Pernah Kedaluwarsa | FALSE |
| Akun Dinonaktifkan | FALSE |
| Grup | Pengguna Domain |
| Profil | Kosong |
| Akun Tidak Pernah Kedaluwarsa | TRUE |
Untuk membuat pengguna lokal, ikat ke komputer target, seperti yang diperlihatkan dalam contoh kode berikut.
Dim mach As IADsContainer
Dim usr as IADsUser
On Error GoTo Cleanup
Set mach = GetObject("WinNT://MyMachine,Computer")
Set usr = mach.Create("user","jeffsmith")
usr.SetInfo
Cleanup:
If(Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set mach = Nothing
Set usr = Nothing
Pengguna lokal yang baru dibuat akan memiliki properti default yang sama dengan pengguna domain. Namun, keanggotaan grup akan menjadi "pengguna", bukan "pengguna domain".
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | iads.h |