共用方式為


IADsUser 屬性方法

IADsUser介面的屬性方法會取得或設定下表所述的屬性。 如需詳細資訊,請參閱 Interface 屬性方法

屬性

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

被視為可能入侵者的最後一個節點;如果 Intruder 偵測為作用中,則可使用此功能。

存取類型:唯讀

腳本資料類型: 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

Office 位置做為使用者的 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 定義為 30 個位元組的六個元素,每個元素各有 30 個位元組, (選擇性地) Post Office Box、城市或地區、州或省、郵遞區號和國家/地區。

存取類型:讀取/寫入

腳本資料類型: 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
);

設定檔

使用者設定檔的路徑。

存取類型:讀取/寫入

腳本資料類型: 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
);

電話首頁

使用者的住家電話號碼陣列。 在 Active Directory 中,這個屬性是單一值,而且陣列有一個元素。

存取類型:讀取/寫入

腳本資料類型: VARIANT

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

電話行動裝置

使用者的行動電話陣列。 在 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

Interface 屬性方法

IADs::Get

IADs::P ut

WinNT 使用者物件

ADSI WinNT 提供者

LDAP 使用者物件

ADSI LDAP 提供者