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
-
-
存取類型:唯讀
-
腳本資料類型: BSTR
-
// C++ method syntax HRESULT get_BadLoginAddress( [out] BSTR* pbstrBadLoginAddress );
被視為可能入侵者的最後一個節點;如果 Intruder 偵測為作用中,則可使用此功能。
-
-
BadLoginCount
-
-
存取類型:唯讀
-
腳本資料類型: LONG
-
// C++ method syntax HRESULT get_BadLoginCount( [out] LONG* plBadLoginCount );
上次重設後的登入嘗試錯誤次數。
-
-
部門
-
-
存取類型:讀取/寫入
-
腳本資料類型: BSTR
-
// C++ method syntax HRESULT get_Department( [out] BSTR* pbstrDepartment ); HRESULT put_Department( [in] BSTR bstrDepartment );
在使用者所屬的公司內,部門 (OU) 。
-
-
說明
-
-
存取類型:讀取/寫入
-
腳本資料類型: 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
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_FaxNumber( [out] VARIANT* pvarFaxNumber ); HRESULT put_FaxNumber( [in] VARIANT varFaxNumber );
使用者的傳真機碼或號碼。 在 Active Directory 中,這個屬性是單一值, 而 VARIANT 陣列有一個專案。
-
-
名字
-
-
存取類型:讀取/寫入
-
腳本資料類型: 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 );
使用者的主目錄。
-
-
網頁
-
-
存取類型:讀取/寫入
-
腳本資料類型: BSTR
-
// C++ method syntax HRESULT get_HomePage( [out] BSTR* pbstrHomePage ); HRESULT put_HomePage( [in] BSTR bstrHomePage );
使用者首頁的 URL。
-
-
IsAccountLocked
-
-
存取類型:讀取/寫入
-
腳本資料類型: 布林值
-
// C++ method syntax HRESULT get_IsAccountLocked( [out] VARIANT_BOOL* pfIsAccountLocked ); HRESULT put_IsAccountLocked( [in] VARIANT_BOOL fIsAccountLocked );
旗標,指出帳戶是否因為入侵程式偵測而鎖定。 當與 LDAP ADSI 提供者搭配使用時,此屬性的使用方式有限。 如需這些限制的詳細資訊,請參閱 帳戶鎖定 (LDAP 提供者) 。
-
-
語言
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_Languages( [out] VARIANT* pvLanguages ); HRESULT put_Languages( [in] VARIANT vLanguages );
使用者的 BSTR 語言名稱陣列。
-
-
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
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_LoginWorkstations( [out] VARIANT* pvLoginWorkstations ); HRESULT put_LoginWorkstations( [in] VARIANT vLoginWorkstations );
使用者可從中登入之 BSTR 資料類型的工作站位址或名稱。
-
-
管理員
-
-
存取類型:讀取/寫入
-
腳本資料類型: 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
-
-
存取類型:讀取/寫入
-
腳本資料類型: LONG
-
// C++ method syntax HRESULT get_MaxStorage( [out] LONG* plMaxStorage ); HRESULT put_MaxStorage( [in] LONG lMaxStorage );
使用者可以使用的磁碟空間量上限,以 KB 為單位。
-
-
NamePrefix
-
-
存取類型:讀取/寫入
-
腳本資料類型: BSTR
-
// C++ method syntax HRESULT get_NamePrefix( [out] BSTR* pbstrNamePrefix ); HRESULT put_NamePrefix( [in] BSTR bstrNamePrefix );
使用者的名稱前置詞,例如 「Ms.」 或 「Hon」。
-
-
NameSuffix
-
-
存取類型:讀取/寫入
-
腳本資料類型: BSTR
-
// C++ method syntax HRESULT get_NameSuffix( [out] BSTR* pbstrNameSuffix ); HRESULT put_NameSuffix( [in] BSTR bstrNameSuffix );
使用者的名稱尾碼,例如 「Jr.」 或 「III」。
-
-
OfficeLocations
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_OfficeLocations( [out] VARIANT* pvOfficeLocations ); HRESULT put_OfficeLocations( [in] VARIANT vOfficeLocations );
Office 位置做為使用者的 BSTR 陣列。 對於 Active Directory,這個屬性是單一值,而且陣列有一個元素。
-
-
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 );
旗標,指出是否需要密碼。
-
-
圖片
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_Picture( [out] VARIANT* pvarPicture ); HRESULT put_Picture( [in] VARIANT varPicture );
儲存影像之位元組的 OctetString 陣列。
-
-
PostalAddresses
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_PostalAddresses( [out] VARIANT* pvPostalAddresses ); HRESULT put_PostalAddresses( [in] VARIANT vPostalAddresses );
以 BSTR 陣列表示的郵寄地址。 這個屬性是多重值,用來保存超過使用者的位址。 PostalAddress 的內部格式應符合 X.521-1993 中所參考的 CCITT F.401,這會將 PostalAddress 定義為 30 個位元組的六個元素,每個元素各有 30 個位元組, (選擇性地) Post Office Box、城市或地區、州或省、郵遞區號和國家/地區。
-
-
PostalCodes
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_PostalCodes( [out] VARIANT* pvPostalCodes ); HRESULT put_PostalCodes( [in] VARIANT vPostalCodes );
郵遞區號作為 BSTR 陣列。 郵遞區號會以位置連結至 PostalAddresses 陣列。 不過,在 Active Directory 中,這個屬性是單一值,而且陣列具有單一元素。
-
-
設定檔
-
-
存取類型:讀取/寫入
-
腳本資料類型: 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
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_SeeAlso( [out] VARIANT* pvSeeAlso ); HRESULT put_SeeAlso( [in] VARIANT vSeeAlso );
與使用者相關之其他物件的 ADsPaths 陣列。
-
-
電話首頁
-
-
存取類型:讀取/寫入
-
腳本資料類型: 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 );
使用者的行動電話陣列。 在 Active Directory 中,此屬性是單一值,而且陣列只有一個專案。
-
-
TelephoneNumber
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_TelephoneNumber( [out] VARIANT* pvarTelephoneNumber ); HRESULT put_TelephoneNumber( [in] VARIANT varTelephoneNumber );
與使用者相關聯的通常與工作相關的電話號碼陣列。 在 Active Directory 中,這個屬性是單一值,而陣列是單一元素。
-
-
TelephonePager
-
-
存取類型:讀取/寫入
-
腳本資料類型: VARIANT
-
// C++ method syntax HRESULT get_TelephonePager( [out] VARIANT* pvarTelephonePager ); HRESULT put_TelephonePager( [in] VARIANT varTelephonePager );
使用者的呼叫器號碼陣列。 在 Active Directory 中,此屬性是單一值,而且陣列是單一元素。
-
-
標題
-
-
存取類型:讀取/寫入
-
腳本資料類型: 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 |
標頭 |
|
DLL |
|
IID |
IID_IADsUser定義為 3E37E320-17E2-11CF-ABC4-02608C9E7553 |