estrutura ADS_ATTR_INFO (iads.h)

Artigo
02/26/2024

A estrutura ADS_ATTR_INFO é usada para conter um ou mais valores de atributo para uso com o método IDirectoryObject::CreateDSObject, IDirectoryObject::GetObjectAttributes ou IDirectoryObject::SetObjectAttributes .

Sintaxe

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

Membros

pszAttrName

A cadeia de caracteres Unicode terminada em nulo que contém o nome do atributo.

dwControlCode

Contém um dos valores de Tipos de Modificação de Atributo ADSI que determina o tipo de operação a ser executada no valor do atributo.

dwADsType

Um valor da enumeração ADSTYPEENUM que indica o tipo de dados do atributo.

pADsValues

Ponteiro para uma matriz de estruturas ADSVALUE que contêm valores para o atributo.

dwNumValues

Tamanho da matriz pADsValues .

Comentários

No ADSI, atributos e propriedades são usados de forma intercambiável. Defina atributos ao criar um objeto de serviço de diretório usando o método IDirectoryObject::CreateDSObject . A interface IDirectoryObject também dá suporte aos métodos IDirectoryObject::GetObjectAttributes e IDirectoryObject::SetObjectAttributes para recuperar e modificar os atributos do objeto em um diretório.

A memória para a matriz de estruturas ADSVALUE não é alocada com essa estrutura.

O valor do membro dwControlCode é ignorado quando a estrutura é usada como um parâmetro OUT.