IADsProperty

The IADsProperty interface enables a COM object to manage a single property definition for a schema class object in Active Directory. 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 IADsProperty are defined on the ADSI Property Object.

IADsProperty supports methods that describe a property by its name, syntax, value bounds, and any optional attributes that have been defined.

When to Implement

Implement IADsProperty only when you are providing an ADSI implementation for your directory service.

Note  Within a schema class, property names must be unique and valid for use in name-bound operations. Although standard Active Directory practice represents all properties within a class rather than as a global list of properties, the underlying directory service may require property names to be globally unique and have consistent syntax. The provider must ensure there are no name collisions when adding new properties at creation time. Active Directory does allow multiple names for the same property.

When to Use

Call IADsProperty methods when determining at run-time what properties are supported by an ADSI schema class object. These methods are also used when adding new properties and property objects to a specific implementation of Active Directory.

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

IADsProperty Property Methods Description
get/put_OID Directory-specific object identifier.
get/put_Syntax Relative path of syntax object.
get/put_MaxRange Upper limit of values.
get/put_MinRange Lower limit of values.
get/put_MultiValued Whether or not this Is a multi-valued property.
Qualifiers Optional additional provider-specific constraints on this property.