Noms d’affichage des classes et des attributs

Le spécificateur d’affichage d’une classe d’objet contient les attributs suivants qui peuvent être utilisés pour spécifier les noms d’affichage localisés utilisés dans l’interface utilisateur pour les objets de cette classe :

  • L’attribut classDisplayName est une chaîne Unicode à valeur unique qui spécifie le nom complet de la classe.
  • L’attribut attributeDisplayNames est une propriété à valeurs multiples qui spécifie les noms à utiliser dans l’interface utilisateur pour les attributs de la classe d’objets.

Les valeurs attributeDisplayNames sont des chaînes Unicode ; chaque élément se compose d’une paire de noms délimitée par des virgules :

<attribute name>,<display text>

Dans cet exemple, «< nom> d’attribut » est lDAPDisplayName de l’attribut et «< texte d’affichage » est le texte> à afficher comme nom de cet attribut dans l’interface utilisateur.

Instructions pour les noms d’affichage des classes et des attributs

Étant donné que de nombreux fournisseurs peuvent étendre des classes avec de nouveaux attributs ou créer des classes entièrement nouvelles, il est important que les noms d’affichage de classe et d’attribut soient non ambigus et ne entraînent pas de conflits.

Chaque fournisseur doit préfixer le nom complet de la classe avec un identificateur convivial unique basé sur le nom du fournisseur. Par exemple, si l’entreprise fictive, Fabrikam Inc., crée une classe dérivée de la classe « contact », elle peut avoir un nom complet de classe unique « Fabrikam Contact ».

Si un fournisseur étend une classe existante avec de nouveaux attributs, il doit à nouveau identifier de manière unique le nom d’affichage de l’attribut afin qu’aucun conflit ne se produise avec d’autres noms d’affichage d’attribut. Là encore, le préfixe du nom complet de l’attribut avec un identificateur convivial unique basé sur le nom du fournisseur est une bonne pratique. Par exemple, si l’entreprise Fabrikam étend la classe d’utilisateur avec un nouvel attribut HR, elle peut afficher de manière unique l’attribut sous la forme « Fabrikam HR Information ».

En outre, à partir d’une perspective de localisation, chaque fournisseur doit localiser les noms d’affichage de classe et d’attribut dans chaque langue prise en charge par Windows 2000.

Ajout d’une valeur à l’attribut attributeDisplayNames

Pour ajouter une valeur de mappage de nom à l’attribut attributeDisplayNames

  1. Déterminez si la valeur de mappage de nom de l’attribut existe. Si une valeur de mappage de nom doit être remplacée, supprimez d’abord la valeur existante à l’aide de la méthode IADs::P utEx , avec le paramètre lnControlCode défini sur ADS_PROPERTY_DELETE et le paramètre vProp défini sur la valeur à supprimer. N’utilisez pas ADS_PROPERTY_CLEAR ou ADS_PROPERTY_UPDATE pour lnControlCode.
  2. Créez la chaîne qui représente le nom complet de l’attribut. Pour obtenir un exemple, consultez le format ci-dessus.
  3. Utilisez la méthode IADs::P utEx avec le paramètre lnControlCode défini sur ADS_PROPERTY_APPEND pour ajouter la nouvelle valeur.
  4. Appelez IADs::SetInfo pour valider les modifications apportées au répertoire.

Pour plus d’informations sur l’affectation de noms de nouvelles classes et attributs, consultez Affectation de noms d’attributs et de classes.