Criando e excluindo objetos

Com o ADSI, os objetos são criados e excluídos usando a interface IADsContainer ou IDirectoryObject.

Criando um objeto com IADsContainer

Criar um objeto com a interface IADsContainer

1. Associe-se ao contêiner que conterá o objeto a ser criado e obtenha a interface IADsContainer .
2. Use o método IADsContainer.Create para criar um novo objeto no contêiner.
3. Defina os valores para todos os atributos necessários para o objeto usando o método IADs.Put ou IADs.PutEx. Os atributos necessários para criar um objeto dependerão do serviço de diretório e do tipo de objeto criado. Para obter mais informações sobre como criar objetos do Active Directory, consulte Criando e excluindo objetos do Active Directory.
4. Defina os valores para todos os atributos opcionais desejados para o objeto usando o método IADs.Put ou IADs.PutEx.
5. Chame o métodoIADs.SetInfopara confirmar o objeto e seus atributos. O novo objeto não é realmente criado no serviço de diretório subjacente até que o método IADs.SetInfo seja chamado para confirmar os atributos.

Criando um objeto com IDirectoryObject

Criar um objeto com a interface IDirectoryObject

1. Associe-se ao contêiner que conterá o objeto a ser criado e então obtenha a interface IDirectoryObject.
2. Aloque uma matriz de estruturas de ADS_ATTR_INFO que contenha uma estrutura para cada atributo a ser definido quando o objeto for criado.
3. Preencha uma estrutura ADS_ATTR_INFO para cada atributo necessário para o objeto. Os atributos necessários para criar um objeto dependerão do serviço de diretório e do tipo de objeto criado. Para obter mais informações sobre como criar objetos do Active Directory, consulte Criando e excluindo objetos do Active Directory.
4. Preencha uma estrutura ADS_ATTR_INFO para cada atributo opcional para o objeto.
5. Use o métodoIDirectoryObject::CreateDSObject para criar o objeto no contêiner. Esse método também grava o objeto no serviço de diretório subjacente. Se a matriz ADS_ATTR_INFO não contiver todos os atributos necessários para o objeto, IDirectoryObject::CreateDSObject falhará.

Excluindo um objeto

Para excluir um objeto, use o método IADsContainer::Delete ou o método IDirectoryObject::DeleteDSObject. Esses métodos falharão se o objeto excluído contiver objetos filho. Utilize o método IADsDeleteOps::DeleteObject para excluir um contêiner e todos os objetos filhos do contêiner.

O que acontece com um objeto excluído depende do serviço de diretório subjacente. Para obter mais informações sobre como excluir objetos do Active Directory, consulte Criando e excluindo objetos do Active Directory.