Bagikan melalui

Metode Properti IADsUser

  • Artikel

Metode properti antarmuka IADsUser mendapatkan atau mengatur properti yang dijelaskan dalam tabel berikut. Untuk informasi selengkapnya, lihat Metode Properti Antarmuka.

Properti

AccountDisabled

Bendera untuk menunjukkan apakah akun tersebut, atau harus, dinonaktifkan.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: Boolean

// C++ method syntax
HRESULT get_AccountDisabled(
  [out] VARIANT_BOOL* pfAccountDisabled
);
HRESULT put_AccountDisabled(
  [in] VARIANT_BOOL fAccountDisabled
);

AccountExpirationDate

Tanggal dan waktu setelah itu pengguna tidak dapat masuk.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: TANGGAL

// C++ method syntax
HRESULT get_AccountExpirationDate(
  [out] DATE* pdateAccountExpirationDate
);
HRESULT put_AccountExpirationDate(
  [in] DATE dateAccountExpirationDate
);

BadLoginAddress

Simpul terakhir yang dianggap sebagai penyusup yang mungkin; ini tersedia jika deteksi Penyusup aktif.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_BadLoginAddress(
  [out] BSTR* pbstrBadLoginAddress
);

BadLoginCount

Jumlah upaya masuk yang buruk sejak reset terakhir.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: LONG

// C++ method syntax
HRESULT get_BadLoginCount(
  [out] LONG* plBadLoginCount
);

Departemen

Departemen, unit organisasi (OU), di dalam perusahaan tempat pengguna berada.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_Department(
  [out] BSTR* pbstrDepartment
);
HRESULT put_Department(
  [in] BSTR bstrDepartment
);

Deskripsi

Deskripsi teks pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

Divisi

Divisi dalam perusahaan atau organisasi.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_Division(
  [out] BSTR* pbstrDivision
);
HRESULT put_Division(
  [in] BSTR bstrDivision
);

AlamatEmail

Alamat email pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_EmailAddress(
  [out] BSTR* pbstrEmailAddress
);
HRESULT put_EmailAddress(
  [in] BSTR bstrEmailAddress
);

IDKaryawan

Pengidentifikasi karyawan pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_EmployeeID(
  [out] BSTR* pbstrEmployeeID
);
HRESULT put_EmployeeID(
  [in] BSTR bstrEmployeeID
);

FaxNumber

Nomor faks, atau nomor, pengguna. Di Direktori Aktif, properti ini bernilai tunggal dan array VARIAN memiliki satu elemen.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_FaxNumber(
  [out] VARIANT* pvarFaxNumber
);
HRESULT put_FaxNumber(
  [in] VARIANT varFaxNumber
);

NamaDepan

Nama depan pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_FirstName(
  [out] BSTR* pbstrFirstName
);
HRESULT put_FirstName(
  [in] BSTR bstrFirstName
);

FullName

Nama lengkap pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_FullName(
  [out] BSTR* pbstrFullName
);
HRESULT put_FullName(
  [in] BSTR bstrFullName
);

GraceLoginsAllowed

Berapa kali pengguna dapat masuk setelah kata sandi kedaluwarsa.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: LONG

// C++ method syntax
HRESULT get_GraceLoginsAllowed(
  [out] LONG* plGraceLoginsAllowed
);
HRESULT put_GraceLoginsAllowed(
  [in] LONG lGraceLoginsAllowed
);

GraceLoginsRemaining

Jumlah masuk yang diizinkan sebelum akun dikunci.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: LONG

// C++ method syntax
HRESULT get_GraceLoginsRemaining(
  [out] LONG* plGraceLoginsRemaining
);
HRESULT put_GraceLoginsRemaining(
  [in] LONG lGraceLoginsRemaining
);

HomeDirectory

Direktori beranda pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_HomeDirectory(
  [out] BSTR* pbstrHomeDirectory
);
HRESULT put_HomeDirectory(
  [in] BSTR bstrHomeDirectory
);

« « Situs web

URL untuk halaman beranda pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_HomePage(
  [out] BSTR* pbstrHomePage
);
HRESULT put_HomePage(
  [in] BSTR bstrHomePage
);

IsAccountLocked

Bendera yang menunjukkan apakah akun dikunci karena deteksi penyusup. Properti ini memiliki penggunaan terbatas saat digunakan dengan penyedia LDAP ADSI. Untuk informasi selengkapnya tentang batasan ini, lihat Penguncian Akun (Penyedia LDAP).

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: Boolean

// C++ method syntax
HRESULT get_IsAccountLocked(
  [out] VARIANT_BOOL* pfIsAccountLocked
);
HRESULT put_IsAccountLocked(
  [in] VARIANT_BOOL fIsAccountLocked
);

Bahasa

Array nama bahasa BSTR untuk pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_Languages(
  [out] VARIANT* pvLanguages
);
HRESULT put_Languages(
  [in] VARIANT vLanguages
);

LastFailedLogin

Tanggal dan waktu masuk jaringan terakhir yang gagal.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: TANGGAL

// C++ method syntax
HRESULT get_LastFailedLogin(
  [out] DATE* pdateLastFailedLogin
);

LastLogin

Tanggal dan waktu masuk jaringan terakhir.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: TANGGAL

// C++ method syntax
HRESULT get_LastLogin(
  [out] DATE* pdateLastLogin
);

LastLogoff

Tanggal dan waktu logoff jaringan terakhir.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: TANGGAL

// C++ method syntax
HRESULT get_LastLogoff(
  [out] DATE* pdateLastLogoff
);

NamaBelakang

Nama belakang pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_LastName(
  [out] BSTR* pbstrLastName
);
HRESULT put_LastName(
  [in] BSTR bstrLastName
);

LoginHours

Periode waktu untuk setiap hari dalam seminggu di mana logon diizinkan untuk pengguna. Direpresentasikan sebagai tabel nilai Boolean untuk minggu tersebut, masing-masing menunjukkan apakah slot waktu tersebut adalah waktu masuk yang valid. Ketahuilah bahwa representasinya adalah penyedia dan khusus direktori.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_LoginHours(
  [out] VARIANT* pvLoginHours
);
HRESULT put_LoginHours(
  [in] VARIANT vLoginHours
);

LoginScript

Jalur skrip masuk.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_LoginScript(
  [out] BSTR* pbstrLoginScript
);
HRESULT put_LoginScript(
  [in] BSTR bstrLoginScript
);

LoginWorkstations

Alamat atau nama stasiun kerja, dari jenis data BSTR , tempat pengguna dapat masuk.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_LoginWorkstations(
  [out] VARIANT* pvLoginWorkstations
);
HRESULT put_LoginWorkstations(
  [in] VARIANT vLoginWorkstations
);

Manager

Manajer pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_Manager(
  [out] BSTR* pbstrManager
);
HRESULT put_Manager(
  [in] BSTR bstrManager
);

MaxLogins

Jumlah sesi masuk simultan yang diizinkan.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: LONG

// C++ method syntax
HRESULT get_MaxLogins(
  [out] LONG* plMaxLogins
);
HRESULT put_MaxLogins(
  [in] LONG lMaxLogins
);

MaxStorage

Jumlah maksimum ruang disk, dalam kilobyte, yang dapat digunakan pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: LONG

// C++ method syntax
HRESULT get_MaxStorage(
  [out] LONG* plMaxStorage
);
HRESULT put_MaxStorage(
  [in] LONG lMaxStorage
);

NamePrefix

Awalan nama pengguna, misalnya "Ms.", atau "Hon."

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_NamePrefix(
  [out] BSTR* pbstrNamePrefix
);
HRESULT put_NamePrefix(
  [in] BSTR bstrNamePrefix
);

NameSuffix

Akhiran nama pengguna, misalnya "Jr.", atau "III".

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_NameSuffix(
  [out] BSTR* pbstrNameSuffix
);
HRESULT put_NameSuffix(
  [in] BSTR bstrNameSuffix
);

OfficeLocations

Lokasi Office sebagai array BSTR untuk pengguna. Untuk Direktori Aktif, properti ini bernilai tunggal dan array memiliki satu elemen.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_OfficeLocations(
  [out] VARIANT* pvOfficeLocations
);
HRESULT put_OfficeLocations(
  [in] VARIANT vOfficeLocations
);

OtherName

Nama tambahan, misalnya, nama tengah, untuk pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_OtherName(
  [out] BSTR* pbstrOtherName
);
HRESULT put_OtherName(
  [in] BSTR bstrOtherName
);

PasswordExpirationDate

Tanggal dan waktu saat kata sandi kedaluwarsa.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: TANGGAL

// C++ method syntax
HRESULT get_PasswordExpirationDate(
  [out] DATE* pdatePasswordExpirationDate
);
HRESULT put_PasswordExpirationDate(
  [in] DATE datePasswordExpirationDate
);

PasswordLastChanged

Terakhir kali kata sandi diubah.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: TANGGAL

// C++ method syntax
HRESULT get_PasswordLastChanged(
  [out] DATE* pdatePasswordLastChanged
);

PasswordMinimumLength

Panjang minimum kata sandi.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: LONG

// C++ method syntax
HRESULT get_PasswordMinimumLength(
  [out] LONG* plPasswordMinimumLength
);
HRESULT put_PasswordMinimumLength(
  [in] LONG lPasswordMinimumLength
);

PasswordRequired

Bendera yang menunjukkan apakah kata sandi diperlukan.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: Boolean

// C++ method syntax
VARIANT_BOOL get_PasswordRequired(
  [out] VARIANT_BOOL* pfPasswordRequired
);
HRESULT put_PasswordRequired(
  [in] VARIANT_BOOL fPasswordRequired
);

Gambar

Array OctetString byte yang menyimpan gambar.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_Picture(
  [out] VARIANT* pvarPicture
);
HRESULT put_Picture(
  [in] VARIANT varPicture
);

PostalAddresses

Alamat pos sebagai array BSTR . Properti ini multinilai untuk menyimpan lebih dari alamat pengguna. Format internal PostalAddress harus mematuhi CCITT F.401 sebagaimana direferensikan dalam X.521-1993, yang mendefinisikan PostalAddress sebagai enam elemen masing-masing 30 byte, memegang alamat jalan, (opsional) Kotak Kantor Pos, kota atau lokalitas, negara bagian atau provinsi, Kode Pos, dan Negara/Wilayah.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_PostalAddresses(
  [out] VARIANT* pvPostalAddresses
);
HRESULT put_PostalAddresses(
  [in] VARIANT vPostalAddresses
);

Kode Pos

Kode pos sebagai array BSTR . Kode pos secara posisional ditautkan ke array PostalAddresses . Namun, di Direktori Aktif, properti ini bernilai tunggal dan array memiliki satu elemen.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_PostalCodes(
  [out] VARIANT* pvPostalCodes
);
HRESULT put_PostalCodes(
  [in] VARIANT vPostalCodes
);

Profil

Jalur ke profil pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_Profile(
  [out] BSTR* pbstrProfile
);
HRESULT put_Profile(
  [in] BSTR bstrProfile
);

RequireUniquePassword

Bendera yang menunjukkan apakah kata sandi baru harus berbeda dari yang diketahui melalui riwayat kata sandi.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: Boolean

// C++ method syntax
HRESULT get_RequireUniquePassword(
  [out] VARIANT_BOOL* pfRequireUniquePassword
);
HRESULT put_RequireUniquePassword(
  [in] VARIANT_BOOL fRequireUniquePassword
);

LihatAlso

Array ADsPaths dari objek lain yang terkait dengan pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_SeeAlso(
  [out] VARIANT* pvSeeAlso
);
HRESULT put_SeeAlso(
  [in] VARIANT vSeeAlso
);

TelephoneHome

Array nomor telepon rumah pengguna. Di Direktori Aktif, properti ini bernilai tunggal dan array memiliki satu elemen.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_TelephoneHome(
  [out] VARIANT* pvarTelephoneHome
);
HRESULT put_TelephoneHome(
  [in] VARIANT varTelephoneHome
);

TelephoneMobile

Array nomor ponsel pengguna. Di Direktori Aktif properti ini bernilai tunggal dan array hanya memiliki satu elemen.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_TelephoneMobile(
  [out] VARIANT* pvarTelephoneMobile
);
HRESULT put_TelephoneMobile(
  [in] VARIANT varTelephoneMobile
);

Nomor Telepon

Array, biasanya terkait pekerjaan, nomor telepon yang terkait dengan pengguna. Di Direktori Aktif, properti ini bernilai tunggal dan arraynya adalah elemen tunggal.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_TelephoneNumber(
  [out] VARIANT* pvarTelephoneNumber
);
HRESULT put_TelephoneNumber(
  [in] VARIANT varTelephoneNumber
);

TelephonePager

Array nomor pager pengguna. Di Direktori Aktif properti ini bernilai tunggal dan array adalah elemen tunggal.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: VARIAN

// C++ method syntax
HRESULT get_TelephonePager(
  [out] VARIANT* pvarTelephonePager
);
HRESULT put_TelephonePager(
  [in] VARIANT varTelephonePager
);

Judul

Judul pengguna.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

// C++ method syntax
HRESULT get_Title(
  [out] BSTR* pbstrTitle
);
HRESULT put_Title(
  [in] BSTR bstrTitle
);

Keterangan

Penyedia WinNT yang disediakan oleh Microsoft tidak mendukung semua metode properti IADsUser seperti yang disajikan di atas. Namun, penyedia mendukung properti lain yang dapat diakses menggunakan metode IADs::Get atau IADs::P ut . Untuk informasi selengkapnya dan daftar properti dan contoh kode yang tidak didukung, lihat Objek Pengguna WinNT di Penyedia ADSI WinNT.

Untuk informasi selengkapnya tentang fitur spesifik penyedia ADSI LDAP dari objek kelas pengguna, lihat Objek Pengguna LDAP di Penyedia ADSI LDAP. Topik ini mencakup IADsUser, serta contoh kode untuk mengelola akun pengguna.

Contoh

Contoh kode berikut menunjukkan cara mengikat ke objek akun pengguna dan mengambil nama lengkap pengguna.

Dim usr As IADsUser
Dim sFullName as String

On Error GoTo Cleanup
Set usr = GetObject("WinNT://Fabrikam/JeffSmith,user")
sFullName = usr.FullName

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If

    Set usr = Nothing

Contoh kode berikut menunjukkan cara mengikat ke objek akun pengguna dan mengambil nama lengkap pengguna.

IADsUser *GetUserObject(LPWSTR uPath)
{
    IADsUser *pUser;
    HRESULT hr = ADsGetObject(uPath,IID_IADsUser,(void**)&pUser);
    if (FAILED(hr)) {return NULL;}
    BSTR bstr;
    hr = pUser->get_FullName(&bstr);
    printf("User: %S\n", bstr);
    SysFreeString(bstr);
    return pUser;
}

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista
Server minimum yang didukung
 Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
 IID_IADsUser didefinisikan sebagai 3E37E320-17E2-11CF-ABC4-02608C9E7553

Lihat juga

IADsUser

Metode Properti Antarmuka

IADs::Get

IAD::P ut

Objek Pengguna WinNT

Penyedia ADSI WinNT

Objek Pengguna LDAP

Penyedia ADSI LDAP