Platform SDK: Active Directory, ADSI, and 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.

The IADs interface supports the following properties and methods.

Methods in Vtable Order

IUnknown methods	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.

IDispatch methods	Description
GetTypeInfoCount	Gets the number of type descriptions.
GetTypeInfo	Gets a description of the object's programmable interface.
GetIDsOfNames	Maps the name of the method or property to DISPID.
Invoke	Calls one of the object's methods, or gets and sets one of its properties.

IADs property methods	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.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.