Directory Service Technology Introduction--ADSI (III)

Table 1 Properties of the IADs interface
Property name
Type
Description

Name
BSTR
Object Name

AdsPath
BSTR
The full path of the object

Class
BSTR
Class of object (path to table structure object)

Guid
BSTR
The globally unique identifier (GUID) of the object

Parent
BSTR
Path of Parent Containment

Schema
BSTR
The path of the table-structured object

Table 2 method of IADs interface
Method name
Parameters
Description

GetInfo

Reload object with attribute value

SetInfo

Change in the value of a commit property

Get
BSTR Bstrname,
VARIANT *pvprop
Gets the property value of the specified name

Put
BSTR Bstrname,
VARIANT Vprop
Sets the property value for the specified name

GetEx
BSTR Bstrname,
VARIANT *pvprop
Gets the value of a single or multi-valued attribute of the specified name

PutEx
LONG Lncontrolcode,
BSTR Bstrname,
VARIANT Vprop
Sets the value of a single or multi-valued property for the specified name; if Lncontrolcode is ads_property_clear, you can delete the property

GetInfoEx
VARIANT Vprops,
LONG lreserved
Similar to GetInfo, optimal processing

Another important interface is IADsContainer, which is the interface that all package container objects must implement. The properties and methods of the IADsContainer interface are shown in table 3 and table 4.
Table 3 Properties of the IADsContainer interface
Property name
Type
Description

Count
Long
Number of objects in the containment

_NewEnum
Lpunknown
Returns an enumerator for objects in the containment

Filter
VARIANT
BSTR Array, each BSTR specifies the definition of the filter

Hints
VARIANT
An array of properties that is similar in use to GetInfoEx

Table 4 method of IADsContainer interface
Method name
Parameters
Description

GetObject
BSTR Bstrclass,
BSTR Bstrrelativename,
Lpdispatch *pnewobject
Gets the IDispatch interface pointer for the specified object in the Package container object

Create
BSTR Bstrclass,
BSTR Bstrrelativename,
Lpdispatch *pnewobject
Creates a directory object of the specified name in the Package container object and returns the object's IDispatch interface pointer

Delete