Modificando atributos com ADSI

Para modificar valores de atributo, o ADSI fornece os métodos IADs.Put e IADs.PutEx. Esses métodos modificam os dados no cache do lado do cliente. O método IADs.SetInfo deve ser chamado para confirmar as alterações no diretório.

Observação

Quando várias alterações de atributo são confirmadas em uma única chamada para IADs.SetInfo, se qualquer atributo único não puder ser modificado, nenhum dos atributos será modificado. Por exemplo, se você modificar os atributos sn e givenName e limpar o atributo telephoneNumber de um objeto de usuário sem chamadas subsequentes para o método SetInfo, as alterações serão inseridas quando você chamar SetInfo. Se uma ou mais das modificações não forem permitidas e, portanto, não puderem ser executadas, nenhuma das modificações coletivas feitas nos atributos será inserida durante a chamada para SetInfo.

 

O método IADs.Put usa um nome de atributo e um parâmetro variant. Use esse método para definir atributos que contêm valores únicos e múltiplos.

O método IADs.PutEx fornece controle sobre operações em atributos de valores múltiplos. Você pode acrescentar, excluir, atualizar e limpar valores existentes. O método IADs.PutEx sempre espera uma matriz variante de valores de atributo. No entanto, você também pode usar esse método para definir um atributo com um único valor.

O método IADs.PutEx usa as operações especificadas pela enumeração ADS_PROPERTY_OPERATION_ENUM.