IADsUser-Eigenschaftsmethoden

Die Eigenschaftenmethoden der IADsUser-Schnittstelle erhalten oder legen die in der folgenden Tabelle beschriebenen Eigenschaften fest. Weitere Informationen finden Sie unter Schnittstelleneigenschaftsmethoden.

Eigenschaften

AccountDisabled

Ein Flag, das angibt, ob das Konto deaktiviert ist oder sein sollte.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: Boolescher Wert

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

AccountExpirationDate

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

Zugriffstyp: Lesen/Schreiben

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 Eindringlingerkennung aktiv ist.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

BadLoginCount

Die Anzahl fehlerhafter Anmeldeversuche seit dem letzten Zurücksetzen.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: LONG

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

Abteilung

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

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Beschreibung

Die Textbeschreibung des Benutzers.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Division

Die Abteilung innerhalb eines Unternehmens oder einer Organisation.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: BSTR

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

EmployeeID

Der Mitarbeiterbezeichner des Benutzers.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

Vorname

Der Vorname des Benutzers.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: BSTR

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

GraceLoginsAllowed

Gibt an, wie oft sich der Benutzer anmelden kann, nachdem das Kennwort abgelaufen ist.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: LONG

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

HomeDirectory

Das Stammverzeichnis des Benutzers.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

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 Erkennung von Eindringlingen gesperrt ist. Diese Eigenschaft ist bei Verwendung mit dem LDAP-ADSI-Anbieter eingeschränkt. Weitere Informationen zu diesen Einschränkungen finden Sie unter Kontosperrung (LDAP-Anbieter).

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: Boolescher Wert

// 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: Lesen/Schreiben

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

Das Datum und die 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: Lesen/Schreiben

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 angeben, ob dieser Zeitslot eine gültige Anmeldezeit ist. Beachten Sie, dass die Darstellung anbieter- und verzeichnisspezifisch ist.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

LoginScript

Der Anmeldeskriptpfad.

Zugriffstyp: Lesen/Schreiben

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, über die sich der Benutzer anmelden kann.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

Manager

Der Vorgesetzte des Benutzers.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

MaxLogins

Die Anzahl der zulässigen gleichzeitigen Anmeldesitzungen.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: LONG

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

MaxStorage

Die maximale Speicherplatzmenge in Kilobyte, die der Benutzer verwenden kann.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: BSTR

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

OfficeLocations

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

Zugriffstyp: Lesen/Schreiben

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 mittlere Name, für den Benutzer.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

PasswordExpirationDate

Das Datum und die Uhrzeit, zu der das Kennwort abläuft.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: DATE

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

PasswordLastChanged

Der Zeitpunkt, zu dem das Kennwort zuletzt geändert wurde.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: DATE

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

PasswordMinimumLength

Die Mindestlänge des Kennworts.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: Boolesch

// 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: Lesen/Schreiben

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 mehrwertige Eigenschaft, die mehr als Adressen des Benutzers enthält. Das interne Format eines PostalAddress-Elements sollte CCITT F.401 entsprechen, wie in X.521-1993 verwiesen wird. Dabei wird ein PostalAddress-Element als sechs Elemente von jeweils 30 Byte definiert, die (optional) Post Office Box, Ort oder Ort, Bundesland oder Provinz, Postleitzahl und Land/Region enthalten.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

PostalCodes

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

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

Profil

Der Pfad zum Benutzerprofil.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

RequireUniquePassword

Ein Flag, das angibt, ob ein neues Kennwort sich von dem unterscheiden soll, das über einen Kennwortverlauf bekannt ist.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: Boolesch

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

SeeAlso

Ein Array von ADsPaths anderer Objekte, die mit dem Benutzer verknüpft sind.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

TelefonStart

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

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

TelephoneMobile

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

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

TelephoneNumber

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

Zugriffstyp: Lesen/Schreiben

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 ein einzelnes Element.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

Titel

Der Titel des Benutzers.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Hinweise

Der von Microsoft bereitgestellte WinNT-Anbieter unterstützt nicht alle IADsUser-Eigenschaftsmethoden, wie oben dargestellt. Der Anbieter unterstützt jedoch andere Eigenschaften, auf die mithilfe 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-Benutzerobjekt im ADSI WinNT-Anbieter.

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

Beispiele

Das folgende Codebeispiel zeigt, wie Sie eine Bindung an ein Benutzerkontoobjekt erstellen 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

Das folgende Codebeispiel zeigt, wie Sie eine Bindung an ein Benutzerkontoobjekt erstellen 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)
Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
IID _ IADsUser ist als 3E37E320-17E2-11CF-ABC4-02608C9E7553 definiert.

Siehe auch

IADsUser

Schnittstelleneigenschaftsmethoden

IADs::Get

IADs::P ut

WinNT-Benutzerobjekt

ADSI WinNT-Anbieter

LDAP-Benutzerobjekt

ADSI LDAP-Anbieter