Interface IADsUser (iads.h)
L’interface IADsUser est une interface double qui hérite des IAD. Il est conçu pour représenter et gérer un compte d’utilisateur final sur un réseau. Appelez les méthodes de cette interface pour accéder aux données du compte d’utilisateur final et les manipuler. Ces données incluent les noms de l’utilisateur, les numéros de téléphone, le titre du poste, etc. Cette interface prend en charge des fonctionnalités permettant de déterminer l’association de groupe de l’utilisateur et de définir ou de modifier le mot de passe.
Pour établir une liaison à un utilisateur de domaine via un fournisseur WinNT, utilisez le nom de domaine dans le cadre d’ADsPath, comme illustré dans l’exemple de code suivant.
GetObject("WinNT://MYDOMAIN/jeffsmith,user")
De même, utilisez le nom de l’ordinateur dans le cadre d’ADsPath pour établir une liaison avec un utilisateur local.
GetObject("WinNT://MYCOMPUTER/jeffsmith,user")
Dans Active Directory, les utilisateurs de domaine résident dans l’annuaire. L’exemple de code suivant montre comment établir une liaison à un utilisateur de domaine via un fournisseur LDAP.
GetObject("LDAP://CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=Com")
Toutefois, les comptes locaux résident dans la base de données SAM locale et le fournisseur LDAP ne communique pas avec la base de données locale. Par conséquent, pour établir une liaison avec un utilisateur local, vous devez passer par un fournisseur WinNT comme décrit dans le deuxième exemple de code.
Héritage
L’interface IADsUser hérite d’IDispatch et d’IADs. IADsUser a également les types de membres suivants :
Méthodes
L’interface IADsUser possède ces méthodes.
| IADsUser::ChangePassword Remplace le mot de passe utilisateur de l’ancienne valeur spécifiée par une nouvelle valeur. |
| IADsUser::Groups Obtient une collection des objets de groupe ADSI auxquels cet utilisateur appartient. |
| IADsUser::SetPassword Définit le mot de passe utilisateur sur une valeur spécifiée. |
Notes
Comme avec tout autre objet ADSI, l’objet conteneur crée un objet de compte d’utilisateur Windows. Tout d’abord, liez à un objet conteneur. Ensuite, appelez la méthode IADsContainer::Create et spécifiez des attributs obligatoires ou facultatifs.
Avec WinNT, vous n’avez pas besoin de spécifier d’attributs supplémentaires lors de la création d’un utilisateur. Vous pouvez appeler la méthode IADsContainer::Create pour créer directement l’objet utilisateur.
Dim dom As IADsContainer
Dim usr As IADsUser
On Error GoTo Cleanup
Set dom = GetObject("WinNT://MyDomain")
Set usr = dom.Create("user","jeffsmith")
usr.SetInfo
Cleanup:
If(Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set mach = Nothing
Set usr = Nothing
Dans ce cas, un utilisateur de domaine est créé avec les valeurs par défaut suivantes.
| Propriété | Valeur |
|---|---|
| Nom complet | Nom du compte SAM (par exemple, jeffsmith) |
| Mot de passe | Vide |
| L’utilisateur doit modifier le mot de passe | TRUE |
| L’utilisateur ne peut pas modifier le mot de passe | FALSE |
| Le mot de passe n’expire jamais | FALSE |
| Compte désactivé | FALSE |
| Groupe | Utilisateur de domaine |
| Profil | Vide |
| Le compte n’expire jamais | TRUE |
Pour créer un utilisateur local, liez à un ordinateur cible, comme illustré dans l’exemple de code suivant.
Dim mach As IADsContainer
Dim usr as IADsUser
On Error GoTo Cleanup
Set mach = GetObject("WinNT://MyMachine,Computer")
Set usr = mach.Create("user","jeffsmith")
usr.SetInfo
Cleanup:
If(Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set mach = Nothing
Set usr = Nothing
L’utilisateur local nouvellement créé aura les mêmes propriétés par défaut que l’utilisateur de domaine. L’appartenance au groupe, toutefois, sera « utilisateurs », au lieu de « utilisateur de domaine ».
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |