ADS_ATTR_INFO structure (iads.h)

The ADS_ATTR_INFO structure is used to contain one or more attribute values for use with the IDirectoryObject::CreateDSObject, IDirectoryObject::GetObjectAttributes, or IDirectoryObject::SetObjectAttributes method.

Syntax

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

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Header iads.h

See also

ADSI Attribute Modification Types

ADSI Constants

ADSI Structures

ADSTYPEENUM

IDirectoryObject

IDirectoryObject::CreateDSObject

IDirectoryObject::GetObjectAttributes

IDirectoryObject::SetObjectAttributes