ADS_ATTR_INFO

The ADS_ATTR_INFO structure holds the value of a named attribute as well as the information 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

Pointer to a string containing the name of the attribute.

dwControlCode

One of the ADS_ATTR_* constants that control what operation to be performed on the attribute. For more information on the ADS_ATTR_* constants, see ADSI Constants.

dwADsType

Data type of the attribute as defined by ADSTYPE.

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. You can 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

  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

ADSI Constants, ADSI Structures, ADSTYPEENUM, IDirectoryObject, IDirectoryObject::CreateDSObject, IDirectoryObject::GetObjectAttributes, IDirectoryObject::SetObjectAttributes