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

Voir aussi

IADs

IADsContainer::Create

IADsUser, méthodes de propriété

IDispatch