Directory Services

IADs

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 in Vtable Order

The IADs interface inherits the methods of the standard COM interfaces:

IUnknown
IDispatch

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	Description
AdsPath	Gets the object's ADsPath that uniquely identifies this object from all others.
Class	Gets the name of the object's schema class.
GUID	Gets the GUID of the object as stored in the underlying directory store.
Name	Gets the object's relative name.
Parent	Gets the ADsPath string for the parent of the object.
Schema	Gets the ADsPath string to the schema class object for this object.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.