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 |