Directory Services

IADsLocality

The IADsLocality interface is a dual interface that inherits from IADs. It is designed to represent 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/region, locality (state/city/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/region, 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.

Methods in Vtable Order

The IADsLocality interface inherits the methods of the standard COM interfaces:

In addition, IADsLocality defines the following methods.

Method Description
get_Description Gets and sets the description of the geographical region as represented by this object.
put_Description Gets and sets the description of the geographical region as represented by this object.
get_LocalityName Gets and sets the name of this region.
put_LocalityName Gets and sets the name of this region.
get_PostalAddress Gets and sets the main post office address of this region.
put_PostalAddress Gets and sets the main post office address of this region.
get_SeeAlso Gets and sets any other information relevant to this region.
put_SeeAlso Gets and sets any other information relevant to this region.

Properties

The IADsLocality interface defines the following properties. The preceding table includes access methods for these properties.

Property Description
Description Gets and sets the description of the geographical region as represented by this object.
LocalityName Gets and sets the name of this region.
PostalAddress Gets and sets the main post office address of this region.
SeeAlso Gets and sets any other information relevant to this region.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

IADsO, IADsOU, IADsLocality Property Methods