Interfaz IADsUser (iads.h)
La interfaz IADsUser es una interfaz dual que hereda de los IAD. Está diseñado para representar y administrar una cuenta de usuario final en una red. Llame a los métodos de esta interfaz para acceder a los datos de la cuenta de usuario final y manipularlos. Estos datos incluyen nombres del usuario, números de teléfono, puesto de trabajo, etc. Esta interfaz admite características para determinar la asociación de grupo del usuario y para establecer o cambiar la contraseña.
Para enlazar a un usuario de dominio a través de un proveedor winNT, use el nombre de dominio como parte de ADsPath, como se muestra en el ejemplo de código siguiente.
GetObject("WinNT://MYDOMAIN/jeffsmith,user")
De forma similar, use el nombre del equipo como parte de ADsPath para enlazar a un usuario local.
GetObject("WinNT://MYCOMPUTER/jeffsmith,user")
En Active Directory, los usuarios del dominio residen en el directorio. En el ejemplo de código siguiente se muestra cómo enlazar a un usuario de dominio a través de un proveedor LDAP.
GetObject("LDAP://CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=Com")
Sin embargo, las cuentas locales residen en la base de datos SAM local y el proveedor LDAP no se comunica con la base de datos local. Por lo tanto, para enlazar a un usuario local, debe pasar por un proveedor winNT como se describe en el segundo ejemplo de código.
Herencia
La interfaz IADsUser hereda de IDispatch e IADs. IADsUser también tiene estos tipos de miembros:
Métodos
La interfaz IADsUser tiene estos métodos.
| IADsUser::ChangePassword Cambia la contraseña de usuario del valor anterior especificado a un nuevo valor. |
| IADsUser::Groups Obtiene una colección de los objetos de grupo ADSI a los que pertenece este usuario. |
| IADsUser::SetPassword Establece la contraseña de usuario en un valor especificado. |
Comentarios
Al igual que con cualquier otro objeto ADSI, el objeto contenedor crea un objeto de cuenta de usuario de Windows. En primer lugar, enlace a un objeto contenedor. A continuación, llame al método IADsContainer::Create y especifique atributos obligatorios u opcionales.
Con WinNT, no es necesario especificar ningún atributo adicional al crear un usuario. Puede llamar al método IADsContainer::Create para crear el objeto de usuario directamente.
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
En este caso, se crea un usuario de dominio con los siguientes valores predeterminados.
| Propiedad | Valor |
|---|---|
| Nombre completo | Nombre de cuenta sam (por ejemplo, jeffsmith) |
| Contraseña | Vacío |
| El usuario debe cambiar la contraseña | TRUE |
| El usuario no puede cambiar la contraseña | FALSE |
| La contraseña nunca expira | FALSE |
| Cuenta deshabilitada | FALSE |
| Grupo | Usuario de dominio |
| Perfil | Vacío |
| La cuenta nunca expira | TRUE |
Para crear un usuario local, enlace a un equipo de destino, como se muestra en el ejemplo de código siguiente.
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
El usuario local recién creado tendrá las mismas propiedades predeterminadas que el usuario del dominio. Sin embargo, la pertenencia a grupos será "usuarios", en lugar de "usuario de dominio".
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | iads.h |