Noms d’affichage des classes et des attributs

  • Article

Le spécificateur d’affichage pour une classe d’objets 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 d’affichage 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ées par des virgules :

<attribute name>,<display text>

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

Instructions pour les noms d’affichage de classes et d’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 des classes et des attributs soient non ambigus et n’entraînent pas de conflits.

Chaque fournisseur doit précéder le nom d’affichage 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 d’affichage 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’attribut. Là encore, le préfixe du nom d’affichage 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 utilisateur avec un nouvel attribut HR, elle peut afficher de manière unique l’attribut sous la forme « Fabrikam HR Information ».

En outre, du point de vue de la localisation, chaque fournisseur doit localiser les noms d’affichage des classes et des attributs 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 pour l’attribut existe. Si une valeur de mappage de noms 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 d’affichage 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 le nommage de nouvelles classes et attributs, consultez Naming Attributes and Classes.