IADsUser, méthodes de propriété
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
-
-
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 );
Indicateur pour indiquer si le compte est ou doit être désactivé.
-
-
AccountExpirationDate
-
-
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 );
Date et heure après lesquelles l’utilisateur ne peut pas se connecter.
-
-
BadLoginAddress
-
-
Type d'accès : Lecture seule
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_BadLoginAddress( [out] BSTR* pbstrBadLoginAddress );
Dernier nœud considéré comme un intrus possible ; cette option est disponible si la détection d’intrus est active.
-
-
BadLoginCount
-
-
Type d'accès : Lecture seule
-
Type de données de script : LONG
-
// C++ method syntax HRESULT get_BadLoginCount( [out] LONG* plBadLoginCount );
Nombre de tentatives d’ouverture de session incorrectes depuis la dernière réinitialisation.
-
-
Département
-
-
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 );
Le service, une unité d’organisation (UO), au sein de l’entreprise à laquelle l’utilisateur appartient.
-
-
Description
-
-
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 );
Description textuelle de l’utilisateur.
-
-
Division
-
-
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 );
Division au sein d’une entreprise ou d’une organization.
-
-
EmailAddress
-
-
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 );
Adresse e-mail de l’utilisateur.
-
-
EmployeeID
-
-
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 );
Identificateur de l’employé de l’utilisateur.
-
-
FaxNumber
-
-
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 );
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.
-
-
FirstName
-
-
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 );
Prénom de l’utilisateur.
-
-
FullName
-
-
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 );
Nom complet de l’utilisateur.
-
-
GraceLoginsAllowed
-
-
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 );
Nombre de fois que l’utilisateur peut se connecter après l’expiration du mot de passe.
-
-
GraceLoginsRemaining
-
-
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 );
Nombre de connexions autorisées avant le verrouillage du compte.
-
-
HomeDirectory
-
-
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 );
Répertoire de base de l’utilisateur.
-
-
Accueil
-
-
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 );
URL de la page d’accueil de l’utilisateur.
-
-
IsAccountLocked
-
-
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 );
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).
-
-
Langues
-
-
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 );
Tableau de noms de langue BSTR pour l’utilisateur.
-
-
LastFailedLogin
-
-
Type d'accès : Lecture seule
-
Type de données de script : DATE
-
// C++ method syntax HRESULT get_LastFailedLogin( [out] DATE* pdateLastFailedLogin );
Date et heure de la dernière connexion réseau ayant échoué.
-
-
LastLogin
-
-
Type d'accès : Lecture seule
-
Type de données de script : DATE
-
// C++ method syntax HRESULT get_LastLogin( [out] DATE* pdateLastLogin );
Date et heure de la dernière connexion réseau.
-
-
LastLogoff
-
-
Type d'accès : Lecture seule
-
Type de données de script : DATE
-
// C++ method syntax HRESULT get_LastLogoff( [out] DATE* pdateLastLogoff );
Date et heure de la dernière déconnexion réseau.
-
-
LastName
-
-
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 );
Nom de l’utilisateur.
-
-
LoginHours
-
-
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 );
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.
-
-
LoginScript
-
-
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 );
Chemin du script d’ouverture de session.
-
-
LoginWorkstations
-
-
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 );
Adresses ou noms de stations de travail, du type de données BSTR , à partir desquelles l’utilisateur peut se connecter.
-
-
Manager
-
-
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 );
Gestionnaire de l’utilisateur.
-
-
MaxLogins
-
-
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 );
Nombre de sessions de connexion simultanées autorisées.
-
-
MaxStorage
-
-
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 );
Quantité maximale d’espace disque, en kilo-octets, que l’utilisateur peut utiliser.
-
-
NamePrefix
-
-
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 );
Préfixe de nom de l’utilisateur, par exemple « Ms . » ou « Hon ».
-
-
NameSuffix
-
-
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 );
Suffixe de nom de l’utilisateur, par exemple « Jr . » ou « III ».
-
-
OfficeLocations
-
-
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 );
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.
-
-
OtherName
-
-
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 );
Un nom supplémentaire, par exemple, le deuxième prénom, pour l’utilisateur.
-
-
PasswordExpirationDate
-
-
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 );
Date et heure d’expiration du mot de passe.
-
-
PasswordLastChanged
-
-
Type d'accès : Lecture seule
-
Type de données de script : DATE
-
// C++ method syntax HRESULT get_PasswordLastChanged( [out] DATE* pdatePasswordLastChanged );
Heure de la dernière modification du mot de passe.
-
-
PasswordMinimumLength
-
-
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 );
Longueur minimale du mot de passe.
-
-
PasswordRequired
-
-
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 );
Indicateur qui indique si le mot de passe est requis.
-
-
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 );
Tableau OctetString d’octets qui stocke une image.
-
-
PostalAddresses
-
-
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 );
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.
-
-
Codes postaux
-
-
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 );
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.
-
-
Profil
-
-
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 );
Chemin d’accès au profil utilisateur.
-
-
RequireUniquePassword
-
-
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 );
Indicateur qui indique si un nouveau mot de passe doit être différent de celui connu dans l’historique des mots de passe.
-
-
VoirAlso
-
-
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 );
Tableau d’ADsPaths d’autres objets liés à l’utilisateur.
-
-
TelephoneHome
-
-
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 );
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.
-
-
TelephoneMobile
-
-
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 );
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.
-
-
TelephoneNumber
-
-
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 );
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.
-
-
TelephonePager
-
-
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 );
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.
-
-
Titre
-
-
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 );
Titre de l’utilisateur.
-
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 |
|
DLL |
|
IID |
IID_IADsUser est défini comme 3E37E320-17E2-11CF-ABC4-02608C9E7553 |