通过

IADsUser 属性方法

  • 项目

IADsUser 接口的属性方法获取或设置下表中所述的属性。 有关详细信息，请参阅 接口属性方法。

属性

AccountDisabled

一个标志，指示帐户是禁用还是应该禁用。

访问类型：读/写

脚本数据类型： 布尔值

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

AccountExpirationDate

用户无法登录的日期和时间。

访问类型：读/写

脚本数据类型： DATE

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

BadLoginAddress

被视为可能入侵者的最后一个节点;如果入侵者检测处于活动状态，则此功能可用。

访问类型：只读

脚本数据类型： BSTR

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

BadLoginCount

自上次重置以来的失败登录尝试次数。

访问类型：只读

脚本数据类型： LONG

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

部门

部门，一个组织单位， (OU) ，在用户所属的公司内。

访问类型：读/写

脚本数据类型： BSTR

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

描述

用户的文本说明。

访问类型：读/写

脚本数据类型： BSTR

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

部门

公司或组织内的部门。

访问类型：读/写

脚本数据类型： BSTR

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

EmailAddress

用户的电子邮件地址。

访问类型：读/写

脚本数据类型： BSTR

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

EmployeeID

用户的员工标识符。

访问类型：读/写

脚本数据类型： BSTR

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

FaxNumber

用户的传真号或号码。 在 Active Directory 中，此属性是单值属性， VARIANT 数组有一个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

名字

用户的名字。

访问类型：读/写

脚本数据类型： BSTR

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

FullName

用户的全名。

访问类型：读/写

脚本数据类型： BSTR

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

GraceLoginsAllowed

密码过期后用户可以登录的次数。

访问类型：读/写

脚本数据类型： LONG

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

GraceLoginsRemaining

锁定帐户之前允许的登录次数。

访问类型：读/写

脚本数据类型： LONG

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

HomeDirectory

用户的主目录。

访问类型：读/写

脚本数据类型： BSTR

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

网页

用户主页的 URL。

访问类型：读/写

脚本数据类型： BSTR

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

IsAccountLocked

一个标志，指示帐户是否由于入侵者检测而锁定。 与 LDAP ADSI 提供程序一起使用时，此属性的使用受限。 有关这些限制的详细信息，请参阅 帐户锁定 (LDAP 提供程序) 。

访问类型：读/写

脚本数据类型： 布尔值

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

语言

用户的 BSTR 语言名称数组。

访问类型：读/写

脚本数据类型： VARIANT

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

LastFailedLogin

上次网络登录失败的日期和时间。

访问类型：只读

脚本数据类型： DATE

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

LastLogin

上次网络登录的日期和时间。

访问类型：只读

脚本数据类型： DATE

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

LastLogoff

上次网络注销的日期和时间。

访问类型：只读

脚本数据类型： DATE

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

姓氏

用户的姓氏。

访问类型：读/写

脚本数据类型： BSTR

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

LoginHours

一周中每天允许用户登录的时间段。 表示为一周布尔值的表，每个值指示该时间段是否为有效的登录时间。 请注意，表示形式是特定于提供程序和目录的。

访问类型：读/写

脚本数据类型： VARIANT

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

LoginScript

登录脚本路径。

访问类型：读/写

脚本数据类型： BSTR

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

LoginWorkstations

用户可以从中登录的 BSTR 数据类型的工作站的地址或名称。

访问类型：读/写

脚本数据类型： VARIANT

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

管理员

用户的经理。

访问类型：读/写

脚本数据类型： BSTR

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

MaxLogins

允许的同时登录会话数。

访问类型：读/写

脚本数据类型： LONG

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

MaxStorage

用户可以使用的最大磁盘空间量（以 KB 为单位）。

访问类型：读/写

脚本数据类型： LONG

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

NamePrefix

用户的名称前缀，例如“Ms.”或“Hon”。

访问类型：读/写

脚本数据类型： BSTR

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

NameSuffix

用户的名称后缀，例如“Jr.”或“III”。

访问类型：读/写

脚本数据类型： BSTR

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

OfficeLocations

作为用户的 BSTR 数组的办公位置。 对于 Active Directory，此属性为单值，数组具有一个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

OtherName

用户的附加名称，例如中间名。

访问类型：读/写

脚本数据类型： BSTR

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

PasswordExpirationDate

密码过期的日期和时间。

访问类型：读/写

脚本数据类型： DATE

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

PasswordLastChanged

上次更改密码的时间。

访问类型：只读

脚本数据类型： DATE

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

PasswordMinimumLength

密码的最小长度。

访问类型：读/写

脚本数据类型： LONG

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

PasswordRequired

指示是否需要密码的标志。

访问类型：读/写

脚本数据类型： 布尔值

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

图片

存储图像的 OctetString 字节数组。

访问类型：读/写

脚本数据类型： VARIANT

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

PostalAddresses

作为 BSTR 数组的邮政地址。 此属性是多值，用于保存用户的地址数。 PostalAddress 的内部格式应符合 X.521-1993 中引用的 CCITT F.401，该格式将 PostalAddress 定义为 6 个元素，每个元素包含一个 30 字节， (可以选择) 邮政信箱、城市或地区、州或省、邮政编码和国家/地区。

访问类型：读/写

脚本数据类型： VARIANT

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

PostalCodes

BSTR 数组中的邮政编码。 邮政编码按位置链接到 PostalAddresses 数组。 但是，在 Active Directory 中，此属性是单值属性，并且数组具有单个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

Profile

用户配置文件的路径。

访问类型：读/写

脚本数据类型： BSTR

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

RequireUniquePassword

一个标志，指示新密码是否应不同于通过密码历史记录知道的密码。

访问类型：读/写

脚本数据类型： 布尔值

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

SeeAlso

与用户相关的其他对象的 ADsPaths 数组。

访问类型：读/写

脚本数据类型： VARIANT

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

TelephoneHome

用户的住宅电话号码数组。 在 Active Directory 中，此属性为单值，数组具有一个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

TelephoneMobile

用户的移动电话号码数组。 在 Active Directory 中，此属性是单值，数组只有一个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

TelephoneNumber

通常与工作相关的与用户关联的电话号码数组。 在 Active Directory 中，此属性为单值，数组为单个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

TelephonePager

用户的寻呼号码数组。 在 Active Directory 中，此属性是单值属性，数组是单个元素。

访问类型：读/写

脚本数据类型： VARIANT

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

标题

用户的标题。

访问类型：读/写

脚本数据类型： BSTR

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

备注

Microsoft 提供的 WinNT 提供程序不支持上述所有 IADsUser 属性方法。 但是，提供程序支持可以使用 IADs：：Get 或 IADs：:P ut 方法访问的其他属性。 有关详细信息以及不受支持的属性和代码示例列表，请参阅 ADSI WinNT 提供程序中的 WinNT 用户对象。

有关用户类对象的 ADSI LDAP 提供程序特定功能的详细信息，请参阅 ADSI LDAP 提供程序中的 LDAP 用户对象。 本主题包括 IADsUser，以及用于管理用户帐户的代码示例。

示例

下面的代码示例演示如何绑定到用户帐户对象并检索用户的全名。

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

下面的代码示例演示如何绑定到用户帐户对象并检索用户的全名。

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;
}

要求

要求 值
最低受支持的客户端
 Windows Vista
最低受支持的服务器
 Windows Server 2008
标头
Iads.h
DLL
Activeds.dll
IID
 IID_IADsUser定义为 3E37E320-17E2-11CF-ABC4-02608C9E7553

另请参阅

IADsUser

接口属性方法

IADs：：Get

IADs：:P ut

WinNT 用户对象

ADSI WinNT 提供程序

LDAP 用户对象

ADSI LDAP 提供程序