The IADsLocality interface enables a COM object in Active Directory to manage the data representing geographical location of an accout. This interface is one of several that provide support for directory services that organize accounts by country, locality (geographical location), organization (company), and organizational unit (department). Properties accessed by IADsLocality are defined on the ADSI Locality Object.
Implement IADsLocality when you are providing an Active Directory implementation for your directory service that organizes directory entries by geographical location.
Call the methods on this interface when you are expanding a directory that organizes accounts by physical location.
| 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. |
| IADsLocality Methods | Description |
|---|---|
| get/put_Description | Description of this region. |
| get/put_LocalityName | Name of this region. |
| get/put_PostalAddress | Post office address of this region. |
| get/put_SeeAlso | Any other information relevant to this region. |