Partager via


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