Compartilhar via

Métodos de propriedade IADsUser

  • Artigo

Os métodos de propriedade da interface IADsUser obtêm ou definem as propriedades descritas na tabela a seguir. Para obter mais informações, consulte Métodos de propriedade de interface.

Propriedades

AccountDisabled

Um sinalizador para indicar se a conta está ou deve ser desabilitada.

Tipo de acesso: leitura/gravação

Tipo de dados de script: booliano

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

AccountExpirationDate

A data e a hora após as quais o usuário não pode fazer logon.

Tipo de acesso: leitura/gravação

Tipo de dados de script: DATE

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

BadLoginAddress

O último nó que é considerado um possível intruso; isso estará disponível se a detecção de Intruso estiver ativa.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

BadLoginCount

O número de tentativas de logon inválidas desde a última redefinição.

Tipo de acesso: Somente leitura

Tipo de dados de script: LONG

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

Departamento

O departamento, uma UO (unidade organizacional), dentro da empresa à qual o usuário pertence.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Descrição

A descrição do texto do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Divisão

A divisão dentro de uma empresa ou organização.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

EmailAddress

O endereço de email do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

EmployeeID

O identificador do funcionário do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

FaxNumber

O número de fax, ou números, do usuário. No Active Directory, essa propriedade tem valor único e a matriz VARIANT tem um elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

Nome

Primeiro nome do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

FullName

O nome completo do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

GraceLoginsAllowed

O número de vezes que o usuário pode fazer logon depois que a senha expirar.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

GraceLoginsRemaining

O número de logons permitidos antes que a conta seja bloqueada.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

HomeDirectory

O diretório inicial do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Homepage

A URL da home page do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

IsAccountLocked

Um sinalizador que indica se a conta está bloqueada devido à detecção de intrusos. Essa propriedade tem uso limitado quando usada com o provedor ADSI LDAP. Para obter mais informações sobre essas limitações, consulte Bloqueio de conta (provedor LDAP).

Tipo de acesso: leitura/gravação

Tipo de dados de script: booliano

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

Idiomas

Uma matriz de nomes de idioma BSTR para o usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

LastFailedLogin

A data e a hora do último logon de rede com falha.

Tipo de acesso: Somente leitura

Tipo de dados de script: DATE

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

LastLogin

A data e a hora do último logon de rede.

Tipo de acesso: Somente leitura

Tipo de dados de script: DATE

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

LastLogoff

A data e a hora do último logoff de rede.

Tipo de acesso: Somente leitura

Tipo de dados de script: DATE

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

Sobrenome

Sobrenome do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

LoginHours

Períodos de tempo para cada dia da semana durante os quais os logons são permitidos para o usuário. Representado como uma tabela de valores boolianos para a semana, cada um indicando se esse intervalo de tempo é um tempo de logon válido. Lembre-se de que a representação é específica do provedor e do diretório.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

LoginScript

O caminho do script de logon.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

LoginWorkstations

Endereços ou nomes de estações de trabalho, do tipo de dados BSTR , do qual o usuário pode fazer logon.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

Gerente

O gerente do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

MaxLogins

O número de sessões de logon simultâneas permitidas.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

MaxStorage

A quantidade máxima de espaço em disco, em quilobytes, que o usuário pode usar.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

NamePrefix

Prefixo de nome do usuário, por exemplo, "Ms.", ou "Hon".

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

NameSuffix

Sufixo de nome do usuário, por exemplo, "Jr.", ou "III".

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

OfficeLocations

Local do Office como uma matriz BSTR para o usuário. Para o Active Directory, essa propriedade tem valor único e a matriz tem um elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

OtherName

Um nome adicional, por exemplo, o nome do meio, para o usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

PasswordExpirationDate

A data e a hora em que a senha expira.

Tipo de acesso: leitura/gravação

Tipo de dados de script: DATE

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

PasswordLastChanged

A última vez que a senha foi alterada.

Tipo de acesso: Somente leitura

Tipo de dados de script: DATE

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

PasswordMinimumLength

O comprimento mínimo da senha.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

PasswordRequired

Um sinalizador que indica se a senha é necessária.

Tipo de acesso: leitura/gravação

Tipo de dados de script: booliano

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

Imagem

Uma matriz OctetString de bytes que armazena uma imagem.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

PostalAddresses

Endereço postal como uma matriz BSTR . Essa propriedade tem vários valores para conter mais de endereços do usuário. O formato interno de um PostalAddress deve estar em conformidade com o CCITT F.401, conforme referenciado em X.521-1993, que define um PostalAddress como seis elementos de 30 bytes cada, mantendo um endereço de rua, (opcionalmente) Caixa postal, cidade ou localidade, estado ou província, Cep e País/Região.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

PostalCodes

Códigos postais como uma matriz BSTR . Os códigos postais são vinculados posicionalmente à matriz PostalAddresses . No Active Directory, no entanto, essa propriedade tem valor único e a matriz tem um único elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

Perfil

O caminho para o perfil do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

RequireUniquePassword

Um sinalizador que indica se uma nova senha deve ser diferente daquelas conhecidas por meio de um histórico de senhas.

Tipo de acesso: leitura/gravação

Tipo de dados de script: booliano

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

SeeAlso

Uma matriz de ADsPaths de outros objetos relacionados ao usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

TelephoneHome

Uma matriz de números de telefone residencial do usuário. No Active Directory, essa propriedade tem valor único e a matriz tem um elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

TelephoneMobile

Uma matriz de números de telefone celular do usuário. No Active Directory, essa propriedade tem valor único e a matriz tem apenas um elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

TelephoneNumber

Uma matriz de números de telefone, geralmente relacionados ao trabalho, associados ao usuário. No Active Directory, essa propriedade tem valor único e a matriz é de um único elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

TelephonePager

Uma matriz de números de paginação do usuário. No Active Directory, essa propriedade tem valor único e a matriz é de um único elemento.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

Título

O título do usuário.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Comentários

O provedor WinNT fornecido pela Microsoft não dá suporte a todos os métodos de propriedade IADsUser , conforme apresentado acima. No entanto, o provedor dá suporte a outras propriedades que podem ser acessadas usando o método IADs::Get ou IADs::P ut . Para obter mais informações e uma lista de propriedades e exemplos de código sem suporte, consulte Objeto de Usuário WinNT no Provedor WINNT ADSI.

Para obter mais informações sobre recursos específicos do provedor LDAP ADSI do objeto de classe de usuário, consulte Objeto de usuário LDAP no provedor LDAP ADSI. O tópico inclui IADsUser, bem como exemplos de código para gerenciar uma conta de usuário.

Exemplos

O exemplo de código a seguir mostra como associar a um objeto de conta de usuário e recuperar o nome completo do usuário.

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

O exemplo de código a seguir mostra como associar a um objeto de conta de usuário e recuperar o nome completo do usuário.

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 Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Cabeçalho
Iads.h
DLL
Activeds.dll
IID
 IID_IADsUser é definido como 3E37E320-17E2-11CF-ABC4-02608C9E7553

Confira também

Iadsuser

Métodos de propriedade interface

IADs::Get

IADs::P ut

Objeto de usuário WinNT

Provedor ADSI WinNT

Objeto de usuário LDAP

Provedor LDAP ADSI