Partager via

Création et suppression d’objets

  • Article

Avec ADSI, les objets sont créés et supprimés à l’aide de l’interface IADsContainer ou IDirectoryObject .

Création d’un objet avec IADsContainer

Pour créer un objet avec l’interface IADsContainer

  1. Liez au conteneur qui contiendra l’objet à créer et obtenez l’interface IADsContainer .
  2. Utilisez la méthode IADsContainer.Create pour créer un objet dans le conteneur.
  3. Définissez les valeurs de tous les attributs requis pour l’objet à l’aide de la méthode IADs.Put ou IADs.PutEx . Les attributs requis pour créer un objet dépendent du service d’annuaire et du type d’objet créé. Pour plus d’informations sur la création d’objets Active Directory, consultez Création et suppression d’objets Active Directory.
  4. Définissez les valeurs de tous les attributs facultatifs souhaités pour l’objet à l’aide de la méthode IADs.Put ou IADs.PutEx .
  5. Appelez la méthode IADs.SetInfo pour valider l’objet et ses attributs. Le nouvel objet n’est pas créé dans le service d’annuaire sous-jacent tant que la méthode IADs.SetInfo n’est pas appelée pour valider les attributs.

Création d’un objet avec IDirectoryObject

Pour créer un objet avec l’interface IDirectoryObject

  1. Liez au conteneur qui contiendra l’objet à créer et obtenez l’interface IDirectoryObject .
  2. Allouez un tableau de structures ADS_ATTR_INFO qui contient une structure pour chaque attribut à définir lors de la création de l’objet.
  3. Renseignez une structure ADS_ATTR_INFO pour chaque attribut requis pour l’objet. Les attributs requis pour créer un objet dépendent du service d’annuaire et du type d’objet créé. Pour plus d’informations sur la création d’objets Active Directory, consultez Création et suppression d’objets Active Directory.
  4. Renseignez une structure ADS_ATTR_INFO pour chaque attribut facultatif pour l’objet.
  5. Utilisez la méthode IDirectoryObject::CreateDSObject pour créer l’objet dans le conteneur. Cette méthode valide également l’objet sur le service d’annuaire sous-jacent. Si le tableau ADS_ATTR_INFO ne contient pas tous les attributs requis pour l’objet, IDirectoryObject::CreateDSObject échoue.

Suppression d’un objet

Pour supprimer un objet, utilisez la méthode IADsContainer::D elete ou IDirectoryObject::D eleteDSObject . Ces méthodes échouent si l’objet supprimé contient des objets enfants. Utilisez la méthode IADsDeleteOps::D eleteObject pour supprimer un conteneur et tous les objets enfants du conteneur.

Ce qui arrive à un objet supprimé dépend du service d’annuaire sous-jacent. Pour plus d’informations sur la suppression d’objets Active Directory, consultez Création et suppression d’objets Active Directory.