ADS_ATTR_INFO

The ADS_ATTR_INFO structure holds the value of a named attribute as well as data about operations performed on the attribute.

typedef struct _ADS_ATTR_INFO {

  LPWSTR pszAttrName;

  DWORD dwControlCode;

  ADSTYPE dwADsType;

  PADSVALUE pADsValues;

  DWORD dwNumValues;
} ADS_ATTR_INFO, 

*PADS_ATTR_INFO;

Members

pszAttrName

The null-terminated Unicode string that contains the attribute name.

dwControlCode

Contains one of the ADSI Attribute Modification Types values that determines the type of operation to be performed on the attribute value.

dwADsType

A value from the ADSTYPEENUM enumeration that indicates the data type of the attribute.

pADsValues

Pointer to an array of ADSVALUE structures that contain values for the attribute.

dwNumValues

Size of the pADsValues array.

Remarks

In ADSI, attributes and properties are used interchangeably. Set attributes, when creating a directory service object, using the IDirectoryObject::CreateDSObject method. The IDirectoryObject interface also supports the IDirectoryObject::GetObjectAttributes and IDirectoryObject::SetObjectAttributes methods for retrieving and modifying the attributes of the object in a directory.

Memory for the array of ADSVALUE structures is not allocated with this structure.

The value of the dwControlCode member is ignored when the structure is used as an OUT parameter.

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

ADSI Constants, ADSI Structures, ADSI Attribute Modification Types, ADSTYPEENUM, IDirectoryObject, IDirectoryObject::CreateDSObject, IDirectoryObject::GetObjectAttributes, IDirectoryObject::SetObjectAttributes