IADsBenutzerschnittstelle (iads.h)

Die IADsUser-Schnittstelle ist eine duale Schnittstelle, die von IADs erbt. Es ist für die Darstellung und Verwaltung eines Endbenutzerkontos in einem Netzwerk konzipiert. Rufen Sie die Methoden dieser Schnittstelle auf, um auf Endbenutzerkontodaten zuzugreifen und diese zu bearbeiten. Solche Daten umfassen Namen des Benutzers, Telefonnummern, Berufsbezeichnung usw. Diese Schnittstelle unterstützt Features zum Bestimmen der Gruppenzuordnung des Benutzers und zum Festlegen oder Ändern des Kennworts.

Um eine Bindung an einen Domänenbenutzer über einen WinNT-Anbieter zu erstellen, verwenden Sie den Domänennamen als Teil des ADsPath, wie im folgenden Codebeispiel gezeigt.

GetObject("WinNT://MYDOMAIN/jeffsmith,user")

Verwenden Sie den Computernamen als Teil von ADsPath, um eine Bindung an einen lokalen Benutzer zu erstellen.

GetObject("WinNT://MYCOMPUTER/jeffsmith,user")

In Active Directory befinden sich Domänenbenutzer im Verzeichnis. Das folgende Codebeispiel zeigt, wie sie über einen LDAP-Anbieter an einen Domänenbenutzer gebunden werden.

GetObject("LDAP://CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=Com")

Lokale Konten befinden sich jedoch in der lokalen SAM-Datenbank, und der LDAP-Anbieter kommuniziert nicht mit der lokalen Datenbank. Zum Binden an einen lokalen Benutzer müssen Sie daher einen WinNT-Anbieter durchlaufen, wie im zweiten Codebeispiel beschrieben.

Vererbung

Die IADsUser-Schnittstelle erbt von IDispatch und IADs. IADsUser verfügt auch über folgende Membertypen:

Methoden

Die IADsUser-Schnittstelle verfügt über diese Methoden.

IADsUser::ChangePassword Ändert das Benutzerkennwort vom angegebenen alten Wert in einen neuen Wert.
IADsUser::Groups Ruft eine Auflistung der ADSI-Gruppenobjekte ab, zu denen dieser Benutzer gehört.
IADsUser::SetPassword Legt das Benutzerkennwort auf einen angegebenen Wert fest.

Hinweise

Wie bei jedem anderen ADSI-Objekt erstellt das Containerobjekt ein Windows-Benutzerkontoobjekt. Binden Sie zunächst an ein Containerobjekt. Rufen Sie dann die IADsContainer::Create-Methode auf, und geben Sie obligatorische oder optionale Attribute an.

Mit WinNT müssen Sie beim Erstellen eines Benutzers keine zusätzlichen Attribute angeben. Sie können die IADsContainer::Create-Methode aufrufen, um das Benutzerobjekt direkt zu erstellen.

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

In diesem Fall wird ein Domänenbenutzer mit den folgenden Standardwerten erstellt.

Eigenschaft	Wert
Vollständiger Name	SAM-Kontoname (z. B. jeffsmith)
Kennwort	Leer
Benutzer müssen das Kennwort ändern	TRUE
Der Benutzer kann das Kennwort nicht ändern	FALSE
Kennwort läuft nie ab	FALSE
Konto deaktiviert	FALSE
Gruppieren	Domänenbenutzer
Profil	Leer
Konto läuft nie ab	TRUE

 

Um einen lokalen Benutzer zu erstellen, binden Sie an einen Zielcomputer, wie im folgenden Codebeispiel gezeigt.

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

Der neu erstellte lokale Benutzer verfügt über die gleichen Standardeigenschaften wie der Domänenbenutzer. Die Gruppenmitgliedschaft ist jedoch "Benutzer" anstelle von "Domänenbenutzer".

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h

Weitere Informationen

Iads

IADsContainer::Create

Methoden der IADsUser-Eigenschaft

IDispatch