ADS_ATTR_INFO structure (iads.h)

Article
02/29/2024

La structure ADS_ATTR_INFO est utilisée pour contenir une ou plusieurs valeurs d’attribut à utiliser avec la méthode IDirectoryObject ::CreateDSObject, IDirectoryObject ::GetObjectAttributes ou IDirectoryObject ::SetObjectAttributes .

Syntaxe

typedef struct _ads_attr_info {
  LPWSTR    pszAttrName;
  DWORD     dwControlCode;
  ADSTYPE   dwADsType;
  PADSVALUE pADsValues;
  DWORD     dwNumValues;
} ADS_ATTR_INFO, *PADS_ATTR_INFO;

Membres

pszAttrName

Chaîne Unicode terminée par null qui contient le nom de l’attribut.

dwControlCode

Contient l’une des valeurs types de modification d’attribut ADSI qui détermine le type d’opération à effectuer sur la valeur d’attribut.

dwADsType

Valeur de l’énumération ADSTYPEENUM qui indique le type de données de l’attribut.

pADsValues

Pointeur vers un tableau de structures ADSVALUE qui contiennent des valeurs pour l’attribut .

dwNumValues

Taille du tableau pADsValues .

Remarques

Dans ADSI, les attributs et les propriétés sont utilisés indifféremment. Définissez des attributs lors de la création d’un objet de service d’annuaire, à l’aide de la méthode IDirectoryObject ::CreateDSObject . L’interface IDirectoryObject prend également en charge les méthodes IDirectoryObject ::GetObjectAttributes et IDirectoryObject ::SetObjectAttributes pour récupérer et modifier les attributs de l’objet dans un répertoire.

La mémoire du tableau de structures ADSVALUE n’est pas allouée avec cette structure.

La valeur du membre dwControlCode est ignorée lorsque la structure est utilisée comme paramètre OUT.