Interfaz IADsUser (iads.h)

  • Artículo

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

Consulte también

Iads

IADsContainer::Create

Métodos de propiedad IADsUser

IDispatch