Platform SDK: Active Directory, ADSI, and Directory Services

IADsLocality

The IADsLocality interface is designed for representing the geographical location, or region, of a directory entity. This interface is one of several that provide support for directory services to organize accounts by country, locality (region), organization (company), or organizational unit (department). This interface manages locality, the IADsO interface manages organization, and the IADsOU interface manages the organization unit.

When a directory service provides hierarchical groupings of directory entries by country, locality, organization, or organization unit, you can use this and the related interfaces to expand the directory tree accordingly. In this case, the IADsLocality interface is implemented by a locality object that implements the IADsContainer interface as well.

IADsLocality is a dual interface that inherits from IADs. The IADsLocality interface exposes the following property methods.

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 and sets one of its properties.

IADsLocality property methods Description
get/put_Description Gets and sets the description of the geographical region as represented by this object.
get/put_LocalityName Gets and sets the name of this region.
get/put_PostalAddress Gets and sets the main post office address of this region.
get/put_SeeAlso Gets and sets any other information relevant to this region.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.

See Also

IADsO, IADsOU, IADsLocality Property Methods