Accès au cache de propriétés avec des interfaces IADsProperty

Les interfaces IADsProperty se composent de IADsPropertyList, IADsPropertyEntry et IADsPropertyValue. Ces interfaces fournissent des méthodes permettant d’accéder directement aux propriétés d’un cache d’objets et de les manipuler. Une propriété est appelée entrée de propriété et correspond à un attribut défini dans le schéma. Une entrée de propriété peut avoir une ou plusieurs valeurs de propriété. Un ensemble d’entrées de propriétés est organisé sous la forme d’une liste de propriétés.

L’interface IADsPropertyList gère la liste de propriétés d’un objet ADSI. L’interface IADsPropertyEntry effectue cette opération pour une entrée de propriété. De même, l’interface IADsPropertyValue représente une ou plusieurs valeurs de propriété. Ensemble, ils fournissent un mécanisme permettant aux utilisateurs de :

• Travaillez directement avec le cache de propriétés.
• Utilisez des répertoires qui ne contiennent pas de schémas, tels qu’un serveur LDAP version 2.

Les interfaces IADsProperty* fonctionnent strictement sur le cache de propriétés et ne tentent pas de coopérer avec le serveur pour récupérer ou modifier les données dans le magasin persistant. Par conséquent, ces interfaces sont utilisées uniquement pour examiner et manipuler les propriétés dans le cache du client. Avant d’utiliser ces interfaces, vous devez appeler la méthode IADs::GetInfo ou la méthode IADs::GetInfoEx explicitement pour charger les propriétés de l’objet dans le cache, si le cache n’a pas été initialisé. Après avoir appelé les méthodes de ces interfaces, vous devez appeler IADs::SetInfo pour conserver les modifications apportées au magasin d’annuaires sous-jacent.

Pour plus d’informations et un exemple de code qui peut être utilisé pour implémenter ces interfaces, consultez Exemple de code pour l’utilisation d’interfaces IADsProperty pour accéder au cache de propriétés.