Interface IDirectoryObject (iads.h)
L’interface IDirectoryObject est une interface COM non Automation qui fournit aux clients un accès direct aux objets de service d’annuaire. L’interface active l’accès au moyen d’un protocole direct over-the-wire, plutôt que par le biais du cache d’attributs ADSI. L’utilisation du protocole over-the-wire optimise les performances. Avec IDirectoryObject, un client peut obtenir ou définir n’importe quel nombre d’attributs d’objet avec un seul appel de méthode. Contrairement aux méthodes Automation correspondantes, qui sont appelées par lot, celles d’IDirectoryObject sont exécutées lorsqu’elles sont appelées. IDirectoryObject n’effectue aucune mise en cache d’attribut.
Les clients non Automation peuvent appeler les méthodes d’IDirectoryObject pour optimiser les performances et tirer parti des interfaces de service d’annuaire natives. Les clients Automation ne peuvent pas utiliser IDirectoryObject. Au lieu de cela, ils doivent utiliser l’interface IADs .
Parmi les fournisseurs ADSI fournis par le système, seul le fournisseur LDAP prend en charge cette interface.
Héritage
L’interface IDirectoryObject hérite de l’interface IUnknown. IDirectoryObject a également les types de membres suivants :
Méthodes
L’interface IDirectoryObject possède ces méthodes.
| IDirectoryObject ::CreateDSObject Crée un enfant de l’objet de service d’annuaire actif. |
| IDirectoryObject ::D eleteDSObject Supprime un objet feuille dans une arborescence de répertoires. |
| IDirectoryObject ::GetObjectAttributes Récupère un ou plusieurs attributs spécifiés de l’objet de service d’annuaire. |
| IDirectoryObject ::GetObjectInformation La méthode IDirectoryObject ::GetObjectInformation récupère un pointeur vers une structure de ADS_OBJECT_INFO qui contient des données relatives à l’identité et à l’emplacement d’un objet de service d’annuaire. |
| IDirectoryObject ::SetObjectAttributes La méthode IDirectoryObject ::SetObjectAttributes modifie les données d’un ou plusieurs attributs d’objet spécifiés définis dans la structure ADS_ATTR_INFO. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |