Methoden der IADsUser-Eigenschaft

  • Artikel

Die Eigenschaftenmethoden der IADsUser-Schnittstelle rufen die in der folgenden Tabelle beschriebenen Eigenschaften ab oder legen sie fest. Weitere Informationen finden Sie unter Methoden der Schnittstelleneigenschaft.

Eigenschaften

AccountDisabled

Ein Flag, das angibt, ob das Konto deaktiviert ist oder werden soll.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: Boolean

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

AccountExpirationDate

Das Datum und die Uhrzeit, nach denen sich der Benutzer nicht anmelden kann.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: DATE

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

BadLoginAddress

Der letzte Knoten, der als möglicher Eindringling betrachtet wird; dies ist verfügbar, wenn die Eindringlingserkennung aktiv ist.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

BadLoginCount

Die Anzahl der fehlerhaften Anmeldeversuche seit der letzten Zurücksetzung.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: LONG

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

Abteilung

Die Abteilung, eine Organisationseinheit (OU), innerhalb des Unternehmens, zu dem der Benutzer gehört.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

Beschreibung

Die Textbeschreibung des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

Division

Die Division innerhalb eines Unternehmens oder organization.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

EmailAddress

Die E-Mail-Adresse des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

EmployeeID

Der Mitarbeiterbezeichner des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

FaxNumber

Die Faxnummer des Benutzers. In Active Directory ist diese Eigenschaft einwertig, und das VARIANT-Array verfügt über ein Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

Vorname

Der Vorname des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

FullName

Der vollständige Name des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

GraceLoginsAllowed

Die Häufigkeit, mit der sich der Benutzer nach Ablauf des Kennworts anmelden kann.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

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

GraceLoginsRemaining

Die Anzahl der zulässigen Anmeldungen, bevor das Konto gesperrt wird.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

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

HomeDirectory

Das Basisverzeichnis des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

Homepage

Die URL für die Startseite des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

IsAccountLocked

Ein Flag, das angibt, ob das Konto aufgrund der Eindringlingserkennung gesperrt ist. Diese Eigenschaft hat eine begrenzte Nutzung, wenn sie mit dem LDAP ADSI-Anbieter verwendet wird. Weitere Informationen zu diesen Einschränkungen finden Sie unter Kontosperrung (LDAP-Anbieter).

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: Boolean

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

Sprachen

Ein Array von BSTR-Sprachnamen für den Benutzer.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

LastFailedLogin

Das Datum und die Uhrzeit der letzten fehlgeschlagenen Netzwerkanmeldung.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: DATE

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

LastLogin

Datum und Uhrzeit der letzten Netzwerkanmeldung.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: DATE

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

LastLogoff

Das Datum und die Uhrzeit der letzten Netzwerkanmeldung.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: DATE

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

Nachname

Der Nachname des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

LoginHours

Zeiträume für jeden Wochentag, in dem Anmeldungen für den Benutzer zulässig sind. Wird als Tabelle mit booleschen Werten für die Woche dargestellt, die jeweils angibt, ob es sich bei diesem Zeitfenster um eine gültige Anmeldezeit handelt. Beachten Sie, dass die Darstellung anbieter- und verzeichnisspezifisch ist.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

LoginScript

Der Anmeldeskriptpfad.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

LoginWorkstations

Adressen oder Namen von Arbeitsstationen des BSTR-Datentyps , von denen sich der Benutzer anmelden kann.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

Manager

Der Manager des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

MaxLogins

Die Anzahl der gleichzeitig zulässigen Anmeldesitzungen.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

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

MaxStorage

Die maximale Speicherplatzmenge (in KB), die der Benutzer verwenden kann.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

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

NamePrefix

Namenspräfix des Benutzers, z. B. "Ms." oder "Hon".

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

NameSuffix

Namenssuffix des Benutzers, z. B. "Jr." oder "III".

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

OfficeLocations

Office-Standort als BSTR-Array für den Benutzer. Für Active Directory ist diese Eigenschaft einwertig, und das Array verfügt über ein Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

OtherName

Ein zusätzlicher Name, z. B. der zweite Name, für den Benutzer.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

PasswordExpirationDate

Das Datum und die Uhrzeit, an dem das Kennwort abläuft.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: DATE

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

PasswordLastChanged

Das letzte Mal, wenn das Kennwort geändert wurde.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: DATE

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

PasswordMinimumLength

Die Mindestlänge des Kennworts.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

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

PasswordRequired

Ein Flag, das angibt, ob das Kennwort erforderlich ist.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: Boolean

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

Bild

Ein OctetString-Array von Bytes, die ein Bild speichern.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

PostalAddresses

Postadresse als BSTR-Array . Diese Eigenschaft ist mehrwertiger, um mehr als Adressen des Benutzers zu enthalten. Das interne Format einer PostalAddress sollte der CCITT F.401 entsprechen, auf die in X.521-1993 verwiesen wird, die eine PostalAddress als sechs Elemente mit jeweils 30 Bytes definiert, die eine Straßenadresse enthalten, (optional) Post Office Box, Stadt oder Ort, Bundesstaat oder Provinz, Postleitzahl und Land/Region.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

Postleitzahlen

Postleitzahlen als BSTR-Array . Postleitzahlen sind positionell mit dem PostalAddresses-Array verknüpft. In Active Directory ist diese Eigenschaft jedoch einwertig, und das Array verfügt über ein einzelnes Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

Profil

Der Pfad zum Benutzerprofil.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

RequireUniquePassword

Ein Flag, das angibt, ob sich ein neues Kennwort von denen unterscheiden soll, die über einen Kennwortverlauf bekannt sind.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: Boolean

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

SieheAlso

Ein Array von ADsPaths anderer Objekte im Zusammenhang mit dem Benutzer.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

TelefonHome

Ein Array von Heimtelefonnummern des Benutzers. In Active Directory ist diese Eigenschaft einwertig, und das Array verfügt über ein Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

TelefonMobile

Ein Array von Mobiltelefonnummern des Benutzers. In Active Directory ist diese Eigenschaft einwertig, und das Array verfügt nur über ein Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

TelephoneNumber

Ein Array von telefonnummern, die in der Regel arbeitsbezogen sind, die dem Benutzer zugeordnet sind. In Active Directory ist diese Eigenschaft einwertig, und das Array besteht aus einem einzelnen Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

TelephonePager

Ein Array von Pagernummern des Benutzers. In Active Directory ist diese Eigenschaft einwertig, und das Array ist aus einem einzelnen Element.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

Titel

Der Titel des Benutzers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

Bemerkungen

Der von Microsoft bereitgestellte WinNT-Anbieter unterstützt nicht alle IADsUser-Eigenschaftenmethoden , wie oben dargestellt. Der Anbieter unterstützt jedoch andere Eigenschaften, auf die mit der IADs::Get - oder IADs::P ut-Methode zugegriffen werden kann. Weitere Informationen und eine Liste nicht unterstützter Eigenschaften und Codebeispiele finden Sie unter WinNT User Object in ADSI WinNT Provider.

Weitere Informationen zu spezifischen Features des ADSI LDAP-Anbieters des Benutzerklassenobjekts finden Sie unter LDAP-Benutzerobjekt im ADSI LDAP-Anbieter. Das Thema enthält IADsUser sowie Codebeispiele für die Verwaltung eines Benutzerkontos.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie eine Bindung an ein Benutzerkontoobjekt herstellen und den vollständigen Namen des Benutzers abrufen.

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

Im folgenden Codebeispiel wird gezeigt, wie Sie eine Bindung an ein Benutzerkontoobjekt herstellen und den vollständigen Namen des Benutzers abrufen.

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;
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Header
Iads.h
DLL
Activeds.dll
IID
 IID_IADsUser ist definiert als 3E37E320-17E2-11CF-ABC4-02608C9E7553

Siehe auch

IADsUser

Methoden der Interface-Eigenschaft

IADs::Get

IADs::P ut

WinNT-Benutzerobjekt

ADSI WinNT-Anbieter

LDAP-Benutzerobjekt

ADSI LDAP-Anbieter