The IADsSyntax interface enables a COM object to identify which syntax among the available Automation Virtual Types its data represents. Active Directory defines a standard set of syntax objects that can be used uniformly across multiple directory service implementations. 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 IADsSyntax, as well as the standard ADSI syntax objects, are defined on ADSI Syntax Object.
Implement IADsSyntax only when you are providing an Active Directory implementation for your directory service. Every provider must implement this interface. If you have a syntax that cannot be directly mapped to a VARTYPE supported by Active Directory, use an array of unsigned bytes (VT_UI1|VT_ARRAY).
Automation Data Types supported by Active Directory are:
Call the IADsSyntax methods when you are processing the property values of any ADSI schema class object instance.
| 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. |
| IADsSyntax Properties | Description |
|---|---|
| get/put_OleAutoDataType | The Automation virtual type constant, VT_xxxx. |