Compartir a través de

Métodos de propiedad IADsUser

  • Artículo

Los métodos de propiedad de la interfaz IADsUser obtienen o establecen las propiedades descritas en la tabla siguiente. Para obtener más información, vea Métodos de propiedad de interfaz.

Propiedades

AccountDisabled

Marca para indicar si la cuenta es o debe estar deshabilitada.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: Boolean

// C++ method syntax
HRESULT get_AccountDisabled(
  [out] VARIANT_BOOL* pfAccountDisabled
);
HRESULT put_AccountDisabled(
  [in] VARIANT_BOOL fAccountDisabled
);

AccountExpirationDate

Fecha y hora después de la cual el usuario no puede iniciar sesión.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: DATE

// C++ method syntax
HRESULT get_AccountExpirationDate(
  [out] DATE* pdateAccountExpirationDate
);
HRESULT put_AccountExpirationDate(
  [in] DATE dateAccountExpirationDate
);

BadLoginAddress

El último nodo que se considera un posible intruso; está disponible si la detección de intrusos está activa.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_BadLoginAddress(
  [out] BSTR* pbstrBadLoginAddress
);

BadLoginCount

Número de intentos de inicio de sesión incorrectos desde el último restablecimiento.

Tipo de acceso: solo lectura

Tipo de datos de scripting: LONG

// C++ method syntax
HRESULT get_BadLoginCount(
  [out] LONG* plBadLoginCount
);

Departamento

El departamento, una unidad organizativa (OU), dentro de la empresa a la que pertenece el usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_Department(
  [out] BSTR* pbstrDepartment
);
HRESULT put_Department(
  [in] BSTR bstrDepartment
);

Descripción

Descripción del texto del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

División

División dentro de una empresa u organización.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_Division(
  [out] BSTR* pbstrDivision
);
HRESULT put_Division(
  [in] BSTR bstrDivision
);

EmailAddress

La dirección de correo electrónico del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_EmailAddress(
  [out] BSTR* pbstrEmailAddress
);
HRESULT put_EmailAddress(
  [in] BSTR bstrEmailAddress
);

EmployeeID

Identificador de empleado del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_EmployeeID(
  [out] BSTR* pbstrEmployeeID
);
HRESULT put_EmployeeID(
  [in] BSTR bstrEmployeeID
);

FaxNumber

Número de fax, o números, del usuario. En Active Directory, esta propiedad tiene un solo valor y la matriz VARIANT tiene un elemento.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_FaxNumber(
  [out] VARIANT* pvarFaxNumber
);
HRESULT put_FaxNumber(
  [in] VARIANT varFaxNumber
);

Nombre

El nombre del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_FirstName(
  [out] BSTR* pbstrFirstName
);
HRESULT put_FirstName(
  [in] BSTR bstrFirstName
);

FullName

Nombre completo del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_FullName(
  [out] BSTR* pbstrFullName
);
HRESULT put_FullName(
  [in] BSTR bstrFullName
);

GraceLoginsAllowed

Número de veces que el usuario puede iniciar sesión después de que la contraseña haya expirado.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

// C++ method syntax
HRESULT get_GraceLoginsAllowed(
  [out] LONG* plGraceLoginsAllowed
);
HRESULT put_GraceLoginsAllowed(
  [in] LONG lGraceLoginsAllowed
);

GraceLoginsRemaining

Número de inicios de sesión permitidos antes de bloquear la cuenta.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

// C++ method syntax
HRESULT get_GraceLoginsRemaining(
  [out] LONG* plGraceLoginsRemaining
);
HRESULT put_GraceLoginsRemaining(
  [in] LONG lGraceLoginsRemaining
);

HomeDirectory

Directorio principal del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_HomeDirectory(
  [out] BSTR* pbstrHomeDirectory
);
HRESULT put_HomeDirectory(
  [in] BSTR bstrHomeDirectory
);

Página principal

Dirección URL de la página principal del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_HomePage(
  [out] BSTR* pbstrHomePage
);
HRESULT put_HomePage(
  [in] BSTR bstrHomePage
);

IsAccountLocked

Marca que indica si la cuenta está bloqueada debido a la detección de intrusos. Esta propiedad tiene un uso limitado cuando se usa con el proveedor ADSI LDAP. Para obtener más información sobre estas limitaciones, vea Bloqueo de cuenta (proveedor LDAP).

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: Boolean

// C++ method syntax
HRESULT get_IsAccountLocked(
  [out] VARIANT_BOOL* pfIsAccountLocked
);
HRESULT put_IsAccountLocked(
  [in] VARIANT_BOOL fIsAccountLocked
);

Idiomas

Matriz de nombres de lenguaje BSTR para el usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_Languages(
  [out] VARIANT* pvLanguages
);
HRESULT put_Languages(
  [in] VARIANT vLanguages
);

LastFailedLogin

Fecha y hora del último inicio de sesión de red con errores.

Tipo de acceso: solo lectura

Tipo de datos de scripting: DATE

// C++ method syntax
HRESULT get_LastFailedLogin(
  [out] DATE* pdateLastFailedLogin
);

LastLogin

Fecha y hora del último inicio de sesión de red.

Tipo de acceso: solo lectura

Tipo de datos de scripting: DATE

// C++ method syntax
HRESULT get_LastLogin(
  [out] DATE* pdateLastLogin
);

LastLogoff

Fecha y hora del último inicio de sesión de red.

Tipo de acceso: solo lectura

Tipo de datos de scripting: DATE

// C++ method syntax
HRESULT get_LastLogoff(
  [out] DATE* pdateLastLogoff
);

Apellidos

Los apellidos del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_LastName(
  [out] BSTR* pbstrLastName
);
HRESULT put_LastName(
  [in] BSTR bstrLastName
);

LoginHours

Períodos de tiempo para cada día de la semana durante el cual se permiten inicios de sesión para el usuario. Representado como una tabla de valores booleanos para la semana, cada uno de los cuales indica si esa ranura de tiempo es una hora de inicio de sesión válida. Tenga en cuenta que la representación es específica del proveedor y del directorio.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_LoginHours(
  [out] VARIANT* pvLoginHours
);
HRESULT put_LoginHours(
  [in] VARIANT vLoginHours
);

LoginScript

Ruta de acceso del script de inicio de sesión.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_LoginScript(
  [out] BSTR* pbstrLoginScript
);
HRESULT put_LoginScript(
  [in] BSTR bstrLoginScript
);

LoginWorkstations

Direcciones o nombres de estaciones de trabajo, del tipo de datos BSTR , desde el que el usuario puede iniciar sesión.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_LoginWorkstations(
  [out] VARIANT* pvLoginWorkstations
);
HRESULT put_LoginWorkstations(
  [in] VARIANT vLoginWorkstations
);

Administrador

Administrador del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_Manager(
  [out] BSTR* pbstrManager
);
HRESULT put_Manager(
  [in] BSTR bstrManager
);

MaxLogins

Número de sesiones de inicio de sesión simultáneas permitidas.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

// C++ method syntax
HRESULT get_MaxLogins(
  [out] LONG* plMaxLogins
);
HRESULT put_MaxLogins(
  [in] LONG lMaxLogins
);

MaxStorage

Cantidad máxima de espacio en disco, en kilobytes, que el usuario puede usar.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

// C++ method syntax
HRESULT get_MaxStorage(
  [out] LONG* plMaxStorage
);
HRESULT put_MaxStorage(
  [in] LONG lMaxStorage
);

NamePrefix

Prefijo de nombre del usuario, por ejemplo, "Ms.", o "Hon".

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_NamePrefix(
  [out] BSTR* pbstrNamePrefix
);
HRESULT put_NamePrefix(
  [in] BSTR bstrNamePrefix
);

Sufijonombre

Sufijo de nombre del usuario, por ejemplo, "Jr.", o "III".

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_NameSuffix(
  [out] BSTR* pbstrNameSuffix
);
HRESULT put_NameSuffix(
  [in] BSTR bstrNameSuffix
);

OfficeLocations

Ubicación de Office como matriz BSTR para el usuario. Para Active Directory, esta propiedad tiene un solo valor y la matriz tiene un elemento .

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_OfficeLocations(
  [out] VARIANT* pvOfficeLocations
);
HRESULT put_OfficeLocations(
  [in] VARIANT vOfficeLocations
);

OtherName

Un nombre adicional, por ejemplo, el nombre intermedio para el usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_OtherName(
  [out] BSTR* pbstrOtherName
);
HRESULT put_OtherName(
  [in] BSTR bstrOtherName
);

PasswordExpirationDate

Fecha y hora en que expira la contraseña.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: DATE

// C++ method syntax
HRESULT get_PasswordExpirationDate(
  [out] DATE* pdatePasswordExpirationDate
);
HRESULT put_PasswordExpirationDate(
  [in] DATE datePasswordExpirationDate
);

PasswordLastChanged

La última vez que se cambió la contraseña.

Tipo de acceso: solo lectura

Tipo de datos de scripting: DATE

// C++ method syntax
HRESULT get_PasswordLastChanged(
  [out] DATE* pdatePasswordLastChanged
);

PasswordMinimumLength

Longitud mínima de la contraseña.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: LONG

// C++ method syntax
HRESULT get_PasswordMinimumLength(
  [out] LONG* plPasswordMinimumLength
);
HRESULT put_PasswordMinimumLength(
  [in] LONG lPasswordMinimumLength
);

PasswordRequired

Marca que indica si se requiere la contraseña.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: Boolean

// C++ method syntax
VARIANT_BOOL get_PasswordRequired(
  [out] VARIANT_BOOL* pfPasswordRequired
);
HRESULT put_PasswordRequired(
  [in] VARIANT_BOOL fPasswordRequired
);

Imagen

Matriz OctetString de bytes que almacenan una imagen.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_Picture(
  [out] VARIANT* pvarPicture
);
HRESULT put_Picture(
  [in] VARIANT varPicture
);

PostalAddresses

Dirección postal como matriz BSTR . Esta propiedad tiene varios valores para contener más que las direcciones del usuario. El formato interno de un PostalAddress debe cumplir con CCITT F.401 como se hace referencia en X.521-1993, que define un PostalAddress como seis elementos de 30 bytes cada uno, manteniendo una dirección postal, (opcionalmente) Cuadro de oficina, ciudad o localidad, estado o provincia, Código Postal y País/Región.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_PostalAddresses(
  [out] VARIANT* pvPostalAddresses
);
HRESULT put_PostalAddresses(
  [in] VARIANT vPostalAddresses
);

Códigos postales

Códigos postales como una matriz BSTR . Los códigos postales están vinculados de forma posicional a la matriz PostalAddresses . Sin embargo, en Active Directory, esta propiedad tiene un solo valor y la matriz tiene un solo elemento.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_PostalCodes(
  [out] VARIANT* pvPostalCodes
);
HRESULT put_PostalCodes(
  [in] VARIANT vPostalCodes
);

Perfil

Ruta de acceso al perfil de usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_Profile(
  [out] BSTR* pbstrProfile
);
HRESULT put_Profile(
  [in] BSTR bstrProfile
);

RequireUniquePassword

Marca que indica si una nueva contraseña debe ser diferente de la conocida a través de un historial de contraseñas.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: Boolean

// C++ method syntax
HRESULT get_RequireUniquePassword(
  [out] VARIANT_BOOL* pfRequireUniquePassword
);
HRESULT put_RequireUniquePassword(
  [in] VARIANT_BOOL fRequireUniquePassword
);

SeeAlso

Matriz de ADsPaths de otros objetos relacionados con el usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_SeeAlso(
  [out] VARIANT* pvSeeAlso
);
HRESULT put_SeeAlso(
  [in] VARIANT vSeeAlso
);

TelephoneHome

Matriz de números de teléfono doméstico del usuario. En Active Directory, esta propiedad tiene un solo valor y la matriz tiene un elemento .

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_TelephoneHome(
  [out] VARIANT* pvarTelephoneHome
);
HRESULT put_TelephoneHome(
  [in] VARIANT varTelephoneHome
);

TelephoneMobile

Matriz de números de teléfono móvil del usuario. En Active Directory, esta propiedad tiene un solo valor y la matriz solo tiene un elemento.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_TelephoneMobile(
  [out] VARIANT* pvarTelephoneMobile
);
HRESULT put_TelephoneMobile(
  [in] VARIANT varTelephoneMobile
);

TelephoneNumber

Matriz de números de teléfono asociados al usuario, normalmente relacionados con el trabajo. En Active Directory, esta propiedad tiene un solo valor y la matriz es de un solo elemento.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_TelephoneNumber(
  [out] VARIANT* pvarTelephoneNumber
);
HRESULT put_TelephoneNumber(
  [in] VARIANT varTelephoneNumber
);

TelephonePager

Matriz de números de buscapersonas del usuario. En Active Directory, esta propiedad tiene un valor único y la matriz es de un solo elemento.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: VARIANT

// C++ method syntax
HRESULT get_TelephonePager(
  [out] VARIANT* pvarTelephonePager
);
HRESULT put_TelephonePager(
  [in] VARIANT varTelephonePager
);

Título

Título del usuario.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_Title(
  [out] BSTR* pbstrTitle
);
HRESULT put_Title(
  [in] BSTR bstrTitle
);

Comentarios

El proveedor winNT proporcionado por Microsoft no admite todos los métodos de propiedad IADsUser , como se ha indicado anteriormente. Sin embargo, el proveedor admite otras propiedades a las que se puede tener acceso mediante el método IADs::Get o IADs::P ut . Para obtener más información y una lista de propiedades y ejemplos de código no admitidos, consulta WinNT User Object in ADSI WinNT Provider.

Para obtener más información sobre las características específicas del proveedor LDAP ADSI del objeto de clase de usuario, vea Objeto de usuario LDAP en el proveedor LDAP ADSI. El tema incluye IADsUser, así como ejemplos de código para administrar una cuenta de usuario.

Ejemplos

En el ejemplo de código siguiente se muestra cómo enlazar a un objeto de cuenta de usuario y recuperar el nombre completo del usuario.

Dim usr As IADsUser
Dim sFullName as String

On Error GoTo Cleanup
Set usr = GetObject("WinNT://Fabrikam/JeffSmith,user")
sFullName = usr.FullName

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If

    Set usr = Nothing

En el ejemplo de código siguiente se muestra cómo enlazar a un objeto de cuenta de usuario y recuperar el nombre completo del usuario.

IADsUser *GetUserObject(LPWSTR uPath)
{
    IADsUser *pUser;
    HRESULT hr = ADsGetObject(uPath,IID_IADsUser,(void**)&pUser);
    if (FAILED(hr)) {return NULL;}
    BSTR bstr;
    hr = pUser->get_FullName(&bstr);
    printf("User: %S\n", bstr);
    SysFreeString(bstr);
    return pUser;
}

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Encabezado
Iads.h
Archivo DLL
Activeds.dll
IID
 IID_IADsUser se define como 3E37E320-17E2-11CF-ABC4-02608C9E7553

Consulte también

IADsUser

Métodos de propiedad interface

IADs::Get

IADs::P ut

Objeto de usuario winNT

Proveedor winNT adsi

Objeto de usuario LDAP

Proveedor LDAP ADSI