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