The IADs interface defines the basic object features, that is, properties and methods, of any ADSI object. Examples of ADSI objects include users, computers, services, organization of user accounts and computers, file systems, and file service operations. Every ADSI object must support this interface, which serves to do the following:
- Provides object identification by name, class, or ADsPath
- Identifies the object's container that manages the object's creation and deletion
- Retrieves the object's schema definition
- Loads object's attributes to the property cache and commits changes to the persistent directory store
- Accesses and modifies the object's attribute values in the property cache
The IADs interface is designed to ensure that ADSI objects provide network administrators and directory service providers with a simple and consistent representation of various underlying directory services.
Methods
The IADs interface inherits the methods of the IDispatch interface.
In addition, IADs defines the following methods.
| Method | Description |
|---|
get_Name | Gets the object's relative name.
|
get_Class | Gets the name of the object's schema class.
|
get_GUID | Gets the GUID of the object as stored in the underlying directory store.
|
get_ADsPath | Gets the object's ADsPath that uniquely identifies this object from all others.
|
get_Parent | Gets the ADsPath string for the parent of the object.
|
get_Schema | Gets the ADsPath string to the schema class object for this object.
|
GetInfo |
Loads the property values of this object from the underlying directory store.
|
SetInfo |
Persists the changes on this object to the underlying directory store.
|
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 |
Loads specific property values of this object from the underlying directory store.
|
Properties
The IADs interface defines the following properties. The preceding table includes access methods for these properties.
| Property | Access type | Description |
|---|
AdsPath | Read-only | Gets the object's ADsPath that uniquely identifies this object from all others.
|
Class | Read-only | Gets the name of the object's schema class.
|
GUID | Read-only | Gets the GUID of the object as stored in the underlying directory store.
|
Name | Read-only | Gets the object's relative name.
|
Parent | Read-only | Gets the ADsPath string for the parent of the object.
|
Schema | Read-only | Gets the ADsPath string to the schema class object for this object.
|
Requirements
| Minimum supported client | Windows 2000 Professional |
|---|
| Minimum supported server | Windows 2000 Server |
|---|
| Header | Iads.h |
|---|
| DLL | Activeds.dll |
|---|
| IID | IID_IADs is defined as FD8256D0-FD15-11CE-ABC4-02608C9E7553 |
|---|
Send comments about this topic to Microsoft
Build date: 1/15/2009