Share via

IADsUser, méthodes de propriété

  • Article

Les méthodes de propriété de l’interface IADsUser obtiennent ou définissent les propriétés décrites dans le tableau suivant. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

AccountDisabled

Indicateur pour indiquer si le compte est ou doit être désactivé.

Type d'accès : lecture/écriture

Type de données de script : Boolean

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

AccountExpirationDate

Date et heure après lesquelles l’utilisateur ne peut pas se connecter.

Type d'accès : lecture/écriture

Type de données de script : DATE

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

BadLoginAddress

Dernier nœud considéré comme un intrus possible ; cette option est disponible si la détection d’intrus est active.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

BadLoginCount

Nombre de tentatives d’ouverture de session incorrectes depuis la dernière réinitialisation.

Type d'accès : Lecture seule

Type de données de script : LONG

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

Département

Le service, une unité d’organisation (UO), au sein de l’entreprise à laquelle l’utilisateur appartient.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Description

Description textuelle de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Division

Division au sein d’une entreprise ou d’une organization.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

EmailAddress

Adresse e-mail de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

EmployeeID

Identificateur de l’employé de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

FaxNumber

Numéro de télécopie, ou numéros, de l’utilisateur. Dans Active Directory, cette propriété est à valeur unique et le tableau VARIANT a un élément.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

FirstName

Prénom de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

FullName

Nom complet de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

GraceLoginsAllowed

Nombre de fois que l’utilisateur peut se connecter après l’expiration du mot de passe.

Type d'accès : lecture/écriture

Type de données de script : LONG

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

GraceLoginsRemaining

Nombre de connexions autorisées avant le verrouillage du compte.

Type d'accès : lecture/écriture

Type de données de script : LONG

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

HomeDirectory

Répertoire de base de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Accueil

URL de la page d’accueil de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

IsAccountLocked

Indicateur qui indique si le compte est verrouillé en raison de la détection d’intrus. Cette propriété a une utilisation limitée lorsqu’elle est utilisée avec le fournisseur LDAP ADSI. Pour plus d’informations sur ces limitations, consultez Verrouillage de compte (fournisseur LDAP).

Type d'accès : lecture/écriture

Type de données de script : Boolean

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

Langues

Tableau de noms de langue BSTR pour l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

LastFailedLogin

Date et heure de la dernière connexion réseau ayant échoué.

Type d'accès : Lecture seule

Type de données de script : DATE

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

LastLogin

Date et heure de la dernière connexion réseau.

Type d'accès : Lecture seule

Type de données de script : DATE

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

LastLogoff

Date et heure de la dernière déconnexion réseau.

Type d'accès : Lecture seule

Type de données de script : DATE

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

LastName

Nom de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

LoginHours

Périodes de temps pour chaque jour de la semaine pendant lesquels les connexions sont autorisées pour l’utilisateur. Représentée sous la forme d’une table de valeurs booléennes pour la semaine, chacune indiquant si cette plage horaire est une heure d’ouverture de session valide. N’oubliez pas que la représentation est spécifique au fournisseur et au répertoire.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

LoginScript

Chemin du script d’ouverture de session.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

LoginWorkstations

Adresses ou noms de stations de travail, du type de données BSTR , à partir desquelles l’utilisateur peut se connecter.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

Manager

Gestionnaire de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

MaxLogins

Nombre de sessions de connexion simultanées autorisées.

Type d'accès : lecture/écriture

Type de données de script : LONG

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

MaxStorage

Quantité maximale d’espace disque, en kilo-octets, que l’utilisateur peut utiliser.

Type d'accès : lecture/écriture

Type de données de script : LONG

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

NamePrefix

Préfixe de nom de l’utilisateur, par exemple « Ms . » ou « Hon ».

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

NameSuffix

Suffixe de nom de l’utilisateur, par exemple « Jr . » ou « III ».

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

OfficeLocations

Emplacement office en tant que tableau BSTR pour l’utilisateur. Pour Active Directory, cette propriété a une valeur unique et le tableau a un élément.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

OtherName

Un nom supplémentaire, par exemple, le deuxième prénom, pour l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

PasswordExpirationDate

Date et heure d’expiration du mot de passe.

Type d'accès : lecture/écriture

Type de données de script : DATE

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

PasswordLastChanged

Heure de la dernière modification du mot de passe.

Type d'accès : Lecture seule

Type de données de script : DATE

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

PasswordMinimumLength

Longueur minimale du mot de passe.

Type d'accès : lecture/écriture

Type de données de script : LONG

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

PasswordRequired

Indicateur qui indique si le mot de passe est requis.

Type d'accès : lecture/écriture

Type de données de script : Boolean

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

Image

Tableau OctetString d’octets qui stocke une image.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

PostalAddresses

Adresse postale en tant que tableau BSTR . Cette propriété est à valeurs multiples pour contenir plus que les adresses de l’utilisateur. Le format interne d’une Adresse Postale doit être conforme à la spécification CCITT F.401 référencée dans X.521-1993, qui définit une Adresse Postale comme six éléments de 30 octets chacun, contenant une adresse postale, (éventuellement) une zone postale, une ville ou une localité, un état ou une province, un code postal et un pays/région.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

Codes postaux

Codes postaux sous forme de tableau BSTR . Les codes postaux sont liés par position au tableau PostalAddresses . Dans Active Directory, toutefois, cette propriété est à valeur unique et le tableau a un seul élément.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

Profil

Chemin d’accès au profil utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

RequireUniquePassword

Indicateur qui indique si un nouveau mot de passe doit être différent de celui connu dans l’historique des mots de passe.

Type d'accès : lecture/écriture

Type de données de script : Boolean

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

VoirAlso

Tableau d’ADsPaths d’autres objets liés à l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

TelephoneHome

Tableau des numéros de téléphone de l’utilisateur. Dans Active Directory, cette propriété a une valeur unique et le tableau a un élément.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

TelephoneMobile

Tableau des numéros de téléphone mobile de l’utilisateur. Dans Active Directory, cette propriété est à valeur unique et le tableau n’a qu’un seul élément.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

TelephoneNumber

Tableau de numéros de téléphone, généralement liés au travail, associés à l’utilisateur. Dans Active Directory, cette propriété est à valeur unique et le tableau est d’un élément unique.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

TelephonePager

Tableau de numéros de radiomessagerie de l’utilisateur. Dans Active Directory, cette propriété est à valeur unique et le tableau est d’un élément unique.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

Titre

Titre de l’utilisateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Notes

Le fournisseur WinNT fourni par Microsoft ne prend pas en charge toutes les méthodes de propriété IADsUser , comme indiqué ci-dessus. Toutefois, le fournisseur prend en charge d’autres propriétés accessibles à l’aide de la méthode IADs::Get ou IADs::P ut . Pour plus d’informations et pour obtenir la liste des propriétés et des exemples de code non pris en charge, consultez Objet utilisateur WinNT dans le fournisseur WINNT ADSI.

Pour plus d’informations sur les fonctionnalités spécifiques du fournisseur LDAP ADSI de l’objet de classe utilisateur, consultez Objet utilisateur LDAP dans le fournisseur LDAP ADSI. La rubrique inclut IADsUser, ainsi que des exemples de code pour la gestion d’un compte d’utilisateur.

Exemples

L’exemple de code suivant montre comment établir une liaison à un objet de compte d’utilisateur et récupérer le nom complet de l’utilisateur.

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

L’exemple de code suivant montre comment établir une liaison à un objet de compte d’utilisateur et récupérer le nom complet de l’utilisateur.

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
En-tête
Iads.h
DLL
Activeds.dll
IID
 IID_IADsUser est défini comme 3E37E320-17E2-11CF-ABC4-02608C9E7553

Voir aussi

IADsUser

Méthodes de propriété d’interface

IADs::Get

IADs::P ut

WinNT User Object

Fournisseur WINNT ADSI

Objet utilisateur LDAP

Fournisseur LDAP ADSI