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
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: Boolescher Wert
-
// C++ method syntax HRESULT get_AccountDisabled( [out] VARIANT_BOOL* pfAccountDisabled ); HRESULT put_AccountDisabled( [in] VARIANT_BOOL fAccountDisabled );
Ein Flag, das angibt, ob das Konto deaktiviert ist oder sein sollte.
-
-
AccountExpirationDate
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: DATE
-
// C++ method syntax HRESULT get_AccountExpirationDate( [out] DATE* pdateAccountExpirationDate ); HRESULT put_AccountExpirationDate( [in] DATE dateAccountExpirationDate );
Das Datum und die Uhrzeit, nach der sich der Benutzer nicht anmelden kann.
-
-
BadLoginAddress
-
-
Zugriffstyp: Schreibgeschützt
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_BadLoginAddress( [out] BSTR* pbstrBadLoginAddress );
Der letzte Knoten, der als möglicher Eindringling betrachtet wird. dies ist verfügbar, wenn die Eindringlingerkennung aktiv ist.
-
-
BadLoginCount
-
-
Zugriffstyp: Schreibgeschützt
-
Skriptdatentyp: LONG
-
// C++ method syntax HRESULT get_BadLoginCount( [out] LONG* plBadLoginCount );
Die Anzahl fehlerhafter Anmeldeversuche seit dem letzten Zurücksetzen.
-
-
Abteilung
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Department( [out] BSTR* pbstrDepartment ); HRESULT put_Department( [in] BSTR bstrDepartment );
Die Abteilung, eine Organisationseinheit innerhalb des Unternehmens, zu dem der Benutzer gehört.
-
-
Beschreibung
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Description( [out] BSTR* pbstrDescription ); HRESULT put_Description( [in] BSTR bstrDescription );
Die Textbeschreibung des Benutzers.
-
-
Division
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Division( [out] BSTR* pbstrDivision ); HRESULT put_Division( [in] BSTR bstrDivision );
Die Abteilung innerhalb eines Unternehmens oder einer Organisation.
-
-
EmailAddress
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_EmailAddress( [out] BSTR* pbstrEmailAddress ); HRESULT put_EmailAddress( [in] BSTR bstrEmailAddress );
Die E-Mail-Adresse des Benutzers.
-
-
EmployeeID
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_EmployeeID( [out] BSTR* pbstrEmployeeID ); HRESULT put_EmployeeID( [in] BSTR bstrEmployeeID );
Der Mitarbeiterbezeichner des Benutzers.
-
-
FaxNumber
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_FaxNumber( [out] VARIANT* pvarFaxNumber ); HRESULT put_FaxNumber( [in] VARIANT varFaxNumber );
Die Faxnummer des Benutzers. In Active Directory ist diese Eigenschaft einwertig, und das VARIANT-Array verfügt über ein -Element.
-
-
Vorname
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_FirstName( [out] BSTR* pbstrFirstName ); HRESULT put_FirstName( [in] BSTR bstrFirstName );
Der Vorname des Benutzers.
-
-
FullName
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_FullName( [out] BSTR* pbstrFullName ); HRESULT put_FullName( [in] BSTR bstrFullName );
Der vollständige Name des Benutzers.
-
-
GraceLoginsAllowed
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: LONG
-
// C++ method syntax HRESULT get_GraceLoginsAllowed( [out] LONG* plGraceLoginsAllowed ); HRESULT put_GraceLoginsAllowed( [in] LONG lGraceLoginsAllowed );
Gibt an, wie oft sich der Benutzer anmelden kann, nachdem das Kennwort abgelaufen ist.
-
-
GraceLoginsRemaining
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: LONG
-
// C++ method syntax HRESULT get_GraceLoginsRemaining( [out] LONG* plGraceLoginsRemaining ); HRESULT put_GraceLoginsRemaining( [in] LONG lGraceLoginsRemaining );
Die Anzahl der zulässigen Anmeldungen, bevor das Konto gesperrt wird.
-
-
HomeDirectory
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_HomeDirectory( [out] BSTR* pbstrHomeDirectory ); HRESULT put_HomeDirectory( [in] BSTR bstrHomeDirectory );
Das Stammverzeichnis des Benutzers.
-
-
Homepage
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_HomePage( [out] BSTR* pbstrHomePage ); HRESULT put_HomePage( [in] BSTR bstrHomePage );
Die URL für die Startseite des Benutzers.
-
-
IsAccountLocked
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: Boolescher Wert
-
// C++ method syntax HRESULT get_IsAccountLocked( [out] VARIANT_BOOL* pfIsAccountLocked ); HRESULT put_IsAccountLocked( [in] VARIANT_BOOL fIsAccountLocked );
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).
-
-
Sprachen
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_Languages( [out] VARIANT* pvLanguages ); HRESULT put_Languages( [in] VARIANT vLanguages );
Ein Array von BSTR-Sprachnamen für den Benutzer.
-
-
LastFailedLogin
-
-
Zugriffstyp: Schreibgeschützt
-
Skriptdatentyp: DATE
-
// C++ method syntax HRESULT get_LastFailedLogin( [out] DATE* pdateLastFailedLogin );
Das Datum und die Uhrzeit der letzten fehlgeschlagenen Netzwerkanmeldung.
-
-
LastLogin
-
-
Zugriffstyp: Schreibgeschützt
-
Skriptdatentyp: DATE
-
// C++ method syntax HRESULT get_LastLogin( [out] DATE* pdateLastLogin );
Das Datum und die Uhrzeit der letzten Netzwerkanmeldung.
-
-
LastLogoff
-
-
Zugriffstyp: Schreibgeschützt
-
Skriptdatentyp: DATE
-
// C++ method syntax HRESULT get_LastLogoff( [out] DATE* pdateLastLogoff );
Das Datum und die Uhrzeit der letzten Netzwerkanmeldung.
-
-
Nachname
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_LastName( [out] BSTR* pbstrLastName ); HRESULT put_LastName( [in] BSTR bstrLastName );
Der Nachname des Benutzers.
-
-
LoginHours
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_LoginHours( [out] VARIANT* pvLoginHours ); HRESULT put_LoginHours( [in] VARIANT vLoginHours );
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.
-
-
LoginScript
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_LoginScript( [out] BSTR* pbstrLoginScript ); HRESULT put_LoginScript( [in] BSTR bstrLoginScript );
Der Anmeldeskriptpfad.
-
-
LoginWorkstations
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_LoginWorkstations( [out] VARIANT* pvLoginWorkstations ); HRESULT put_LoginWorkstations( [in] VARIANT vLoginWorkstations );
Adressen oder Namen von Arbeitsstationen des BSTR-Datentyps, über die sich der Benutzer anmelden kann.
-
-
Manager
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Manager( [out] BSTR* pbstrManager ); HRESULT put_Manager( [in] BSTR bstrManager );
Der Vorgesetzte des Benutzers.
-
-
MaxLogins
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: LONG
-
// C++ method syntax HRESULT get_MaxLogins( [out] LONG* plMaxLogins ); HRESULT put_MaxLogins( [in] LONG lMaxLogins );
Die Anzahl der zulässigen gleichzeitigen Anmeldesitzungen.
-
-
MaxStorage
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: LONG
-
// C++ method syntax HRESULT get_MaxStorage( [out] LONG* plMaxStorage ); HRESULT put_MaxStorage( [in] LONG lMaxStorage );
Die maximale Speicherplatzmenge in Kilobyte, die der Benutzer verwenden kann.
-
-
NamePrefix
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_NamePrefix( [out] BSTR* pbstrNamePrefix ); HRESULT put_NamePrefix( [in] BSTR bstrNamePrefix );
Namenspräfix des Benutzers, z.B. "Ms." oder "Hon".
-
-
NameSuffix
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_NameSuffix( [out] BSTR* pbstrNameSuffix ); HRESULT put_NameSuffix( [in] BSTR bstrNameSuffix );
Namenssuffix des Benutzers, z.B. "Jr." oder "III".
-
-
OfficeLocations
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_OfficeLocations( [out] VARIANT* pvOfficeLocations ); HRESULT put_OfficeLocations( [in] VARIANT vOfficeLocations );
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.
-
-
OtherName
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_OtherName( [out] BSTR* pbstrOtherName ); HRESULT put_OtherName( [in] BSTR bstrOtherName );
Ein zusätzlicher Name, z. B. der mittlere Name, für den Benutzer.
-
-
PasswordExpirationDate
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: DATE
-
// C++ method syntax HRESULT get_PasswordExpirationDate( [out] DATE* pdatePasswordExpirationDate ); HRESULT put_PasswordExpirationDate( [in] DATE datePasswordExpirationDate );
Das Datum und die Uhrzeit, zu der das Kennwort abläuft.
-
-
PasswordLastChanged
-
-
Zugriffstyp: Schreibgeschützt
-
Skriptdatentyp: DATE
-
// C++ method syntax HRESULT get_PasswordLastChanged( [out] DATE* pdatePasswordLastChanged );
Der Zeitpunkt, zu dem das Kennwort zuletzt geändert wurde.
-
-
PasswordMinimumLength
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: LONG
-
// C++ method syntax HRESULT get_PasswordMinimumLength( [out] LONG* plPasswordMinimumLength ); HRESULT put_PasswordMinimumLength( [in] LONG lPasswordMinimumLength );
Die Mindestlänge des Kennworts.
-
-
PasswordRequired
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: Boolesch
-
// C++ method syntax VARIANT_BOOL get_PasswordRequired( [out] VARIANT_BOOL* pfPasswordRequired ); HRESULT put_PasswordRequired( [in] VARIANT_BOOL fPasswordRequired );
Ein Flag, das angibt, ob das Kennwort erforderlich ist.
-
-
Bild
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_Picture( [out] VARIANT* pvarPicture ); HRESULT put_Picture( [in] VARIANT varPicture );
Ein OctetString-Array von Bytes, die ein Bild speichern.
-
-
PostalAddresses
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_PostalAddresses( [out] VARIANT* pvPostalAddresses ); HRESULT put_PostalAddresses( [in] VARIANT vPostalAddresses );
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.
-
-
PostalCodes
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_PostalCodes( [out] VARIANT* pvPostalCodes ); HRESULT put_PostalCodes( [in] VARIANT vPostalCodes );
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.
-
-
Profil
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Profile( [out] BSTR* pbstrProfile ); HRESULT put_Profile( [in] BSTR bstrProfile );
Der Pfad zum Benutzerprofil.
-
-
RequireUniquePassword
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: Boolesch
-
// C++ method syntax HRESULT get_RequireUniquePassword( [out] VARIANT_BOOL* pfRequireUniquePassword ); HRESULT put_RequireUniquePassword( [in] VARIANT_BOOL fRequireUniquePassword );
Ein Flag, das angibt, ob ein neues Kennwort sich von dem unterscheiden soll, das über einen Kennwortverlauf bekannt ist.
-
-
SeeAlso
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_SeeAlso( [out] VARIANT* pvSeeAlso ); HRESULT put_SeeAlso( [in] VARIANT vSeeAlso );
Ein Array von ADsPaths anderer Objekte, die mit dem Benutzer verknüpft sind.
-
-
TelefonStart
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_TelephoneHome( [out] VARIANT* pvarTelephoneHome ); HRESULT put_TelephoneHome( [in] VARIANT varTelephoneHome );
Ein Array von Heimtelefonnummern des Benutzers. In Active Directory ist diese Eigenschaft einwertige Eigenschaft, und das Array verfügt über ein Element.
-
-
TelephoneMobile
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_TelephoneMobile( [out] VARIANT* pvarTelephoneMobile ); HRESULT put_TelephoneMobile( [in] VARIANT varTelephoneMobile );
Ein Array von Mobiltelefonnummern des Benutzers. In Active Directory ist diese Eigenschaft einwertige Eigenschaft, und das Array verfügt nur über ein Element.
-
-
TelephoneNumber
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_TelephoneNumber( [out] VARIANT* pvarTelephoneNumber ); HRESULT put_TelephoneNumber( [in] VARIANT varTelephoneNumber );
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.
-
-
TelephonePager
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: VARIANT
-
// C++ method syntax HRESULT get_TelephonePager( [out] VARIANT* pvarTelephonePager ); HRESULT put_TelephonePager( [in] VARIANT varTelephonePager );
Ein Array von Pagernummern des Benutzers. In Active Directory ist diese Eigenschaft einwertig, und das Array ist ein einzelnes Element.
-
-
Titel
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Title( [out] BSTR* pbstrTitle ); HRESULT put_Title( [in] BSTR bstrTitle );
Der Titel des Benutzers.
-
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 |
|
| DLL |
|
| IID |
IID _ IADsUser ist als 3E37E320-17E2-11CF-ABC4-02608C9E7553 definiert. |