IADsClass

The IADsClass interface enables a COM object to provide current schema class definitions for the type of Active Directory objects that can be created in a directory service. IADsClass, IADsProperty, and IADsSyntax make up the interfaces available on schema management objects to view and modify definitions for the schema class objects that define a directory service, including interfaces, properties, methods, containment relationships, and provider-specific rules.

Properties accessed by IADsClass are defined on the ADSI Schema Class Object.

Names of schema classes are those identified through the IADs::get_Schema method. Don't confuse the schema class name with the system CLSID class identifier property which indicates the COM object that implements this COM class.

When to Implement

Implement IADsClass when you are providing an Active Directory implementation for your directory service, or when you are adding functionality to an already existing provider implementation. If your directory service does not support extensible schemas, create an ADSI Schema Container Object that has properties that cannot be modified.

When to Use

Call the methods on IADsClass when you are browsing the ADSI Schema Container Objects in a schema container. These methods define which types of schema classes can contain or be contained by other schema class types. Call these methods whenever you access information about the type of schema object an Active Directory object is. The IADsClass:get_PrimaryInterface method identifies the IID for the interface that QueryInterface uses at run-time to determine whether an object is of a specific schema class.

Methods in VTable Order

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 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.

IADsClass Methods Description
get_PrimaryInterface IID for interface defining this schema class.
get/put_CLSID CLSID of code implementing this schema class.
get/put_OID Directory service-specific Object Identifier.
get/put_Abstract Whether or not this schema class is abstract.
get/put_Auxiliary Whether or not this schema class is auxiliary.
get/put_MandatoryProperties List of required properties needed before saving this object.
get/put_OptionalProperties List of optional properties for this object.
get/put_NamingProperties List of naming attributes for this object..
get/put_DerivedFrom Immediate superclasses of this schema class.
get/put_AuxDerivedFrom Immediate superclasses of this schema class.
get/put_PossibleSuperiors List of classes that can contain instances of this class.
get/put_Containment Legal objects types that can be contained within this container.
get/put_Container Whether or not this is a container object.
get/put_HelpFileName Optional help file name.
get/put_HelpFileContext Optional help file context ID.
Qualifiers Optional collection of provider-specific qualifiers for this property.

See Also

ADSI Schema Class Object, ADSI Schema Container Object