The IADsUser interface enables a COM object in Active Directory to manage information that represents an end-user account on a network.
Properties accessed by IADsUser are defined on the ADSI User Object.
Implement IADsUser only when you are providing an Active Directory implementation for a directory service.
Call the methods on this interface when you are referencing information about an end-user account. This occurs for applications from as simple as creating address books to complex network administration programs that monitor bad password attempts.
| IUnknown Methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| IDispatch Methods | Description |
|---|---|
| GetTypeInfoCount | Gets the number of type descriptions. |
| GetTypeInfo | Gets a description of object's programmable interface. |
| GetIDsOfNames | Maps name of method or property to DISPID. |
| Invoke | Calls one of the object's methods, or gets/sets one of its properties. |
| IADs Properties and Methods | Description |
|---|---|
| get_Name | Gets the object's relative name. |
| get_Class | Gets the object's schema class name. |
| get_GUID | Gets the object's globally unique identifier. |
| get_ADsPath | Gets the object's ADsPath that uniquely identifies this object from all others. |
| get_Parent | Gets the object's ADsPath string for its parent container. |
| get_Schema | Gets the ADsPath string to the schema class definition object for this object. |
| GetInfo | Reloads the changes on this object and its dependents. |
| SetInfo | Saves the changes on this object and its dependents. |
| Get | Gets the value for a property by name. |
| Put | Sets the value for a property by name. |
| GetEx | Gets the value for a single or multi-valued property by name. |
| PutEx | Sets the value for a single or multi-valued property by name. |
| GetInfoEx | Reloads specific property values for this object as they exist in the underlying directory service. |
| IADsUser Properties | Description |
|---|---|
| get_BadLoginAddress | Address of last node considered an "Intruder" |
| get_BadLoginCount | Number of bad logon attempts since last reset. |
| get_LastLogin | Date and time of last network login. |
| get_LastLogoff | Date and time of last network logoff. |
| get_LastFailedLogin | Date and time of last failed network login. |
| get_PasswordLastChanged | Date and time of last password change. |
| get/put_Description | Description of the user account. |
| get/put_Division | Gets and sets the division within a company (organization). |
| get/put_Department | Organizational unit within the organization. |
| get/put_EmployeeID | End-user's employee identification. |
| get/put_FullName | End-user's full name. |
| get/put_FirstName | End-user's first name. |
| get/put_LastName | End-user's last name. |
| get/put_OtherName | End-user's additional name.(nickname, middle name) |
| get/put_NamePrefix | End-user's prefix (Mr. Ms., Hon.) |
| get/put_NameSuffix | End-user's suffix (Jr., III). |
| get/put_Title | End-user's title within the organization. |
| get/put_Manager | End-user's manager. |
| get/put_TelephoneHome | End-user's list of home phone numbers. |
| get/put_TelephoneMobile | End-user's list of mobile phone numbers. |
| get/put_TelephoneNumber | End-user's list of work-related phone numbers. |
| get/put_TelephonePager | End-user's list of pager phone numbers. |
| get/put_FaxNumber | End-user's list of fax phone numbers. |
| get/put_OfficeLocations | Array of end-user locations. |
| get/put_PostalAddresses | Array of end-user post office addresses. |
| get/put_PostalCodes | Array of zip codes for the Postal Addresses. |
| get/put_SeeAlso | Array of ADsPaths of other objects related to this user. |
| get/put_AccountDisabled | Whether or not the account is disabled. |
| get/put_AccountExpirationDate | Date and time after which user cannot log in. |
| get/put_GraceLoginsAllowed | Number of times user can log on after password has expired. |
| get/put_GraceLoginsRemaining | Number of grace logins left before locking account. |
| get/put_IsAccountLocked | Whether or not account is locked. |
| get/put_LoginHours | Time periods during each day of week indicating valid login periods. |
| get/put_LoginWorkstations | Workstations and their net addresses for this end-user. |
| get/put_MaxLogins | Maximum number of simultaneous logins. |
| get/put_MaxStorage | Maximum amount of disk space allowed. |
| get/put_PasswordExpirationDate | Date and time when password will expire. |
| get/put_PasswordMinimumLength | Minimum number of characters allowed in a password. |
| get/put_PasswordRequired | Whether or not password is required. |
| get/put_RequireUniquePassword | Whether or not new password must be different than one in the password history list. |
| get/put_EmailAddress | End-user's email address. |
| get/put_HomeDirectory | End-user's home directory. |
| get/put_Languages | Array of language names for the end-user. |
| get/put_Profile | End-user's profile path. |
| get/put_LoginScript | End-user's logon script path. |
| get/put_Picture | Array of bytes with the end-user's an image. |
| get/put_HomePage | End-user's URL defining a home page. |
| Groups | Determining the groups to which this end-user belongs. |
| SetPassword | Sets the password. |
| ChangePassword | Changes password from specified old value to a new value. |