Freigeben über

Klassen- und Attributanzeigenamen

  • Artikel

Der Anzeigebezeichner für eine Objektklasse enthält die folgenden Attribute, mit denen die lokalisierten Anzeigenamen angegeben werden können, die in der Benutzeroberfläche für Objekte dieser Klasse verwendet werden:

  • Das attribut classDisplayName ist eine Unicode-Zeichenfolge mit einem einzelnen Wert, die den Anzeigenamen der Klasse angibt.
  • Das attribut attributDisplayNames ist eine mehrwertige Eigenschaft, die die Namen angibt, die in der Benutzeroberfläche für Attribute der Objektklasse verwendet werden sollen.

Die attributDisplayNames- Werte sind Unicode-Zeichenfolgen; Jedes Element besteht aus einem durch Trennzeichen getrennten Namenspaar:

<attribute name>,<display text>

In diesem Beispiel ist "<Attributname>" der lDAPDisplayName des Attributs und "<Anzeigetext>" der Text, der als Name dieses Attributs auf der Benutzeroberfläche angezeigt werden soll.

Richtlinien für Klassen- und Attributanzeigenamen

Da viele Anbieter Klassen mit neuen Attributen erweitern oder völlig neue Klassen erstellen können, ist es wichtig, dass die Klassen- und Attributanzeigenamen eindeutig sind und keine Konflikte verursachen.

Jeder Anbieter sollte dem Anzeigenamen der Klasse einen eindeutigen Anzeigebezeichner basierend auf dem Anbieternamen voranstellen. Wenn beispielsweise das fiktive Unternehmen Fabrikam Inc., eine neue Klasse erstellt, die von der Klasse "contact" abgeleitet wird, können sie einen eindeutigen Klassenanzeigenamen "Fabrikam Contact" haben.

Wenn ein Anbieter eine vorhandene Klasse mit neuen Attributen erweitert, sollten sie den Anzeigenamen des Attributs erneut eindeutig identifizieren, sodass keine Konflikte mit anderen Attributanzeigenamen auftreten. Auch hier empfiehlt sich das Präfix des Attributanzeigenamens mit eindeutiger Anzeigebezeichner basierend auf dem Lieferantennamen. Wenn beispielsweise das Fabrikam-Unternehmen die Benutzerklasse mit einem neuen HR-Attribut erweitert, könnte das Attribut eindeutig als "Fabrikam HR Information" angezeigt werden.

Darüber hinaus sollte jeder Anbieter aus Lokalisierungsperspektive die Klassen- und Attributanzeigenamen in jede sprache lokalisieren, die von Windows 2000 unterstützt wird.

Hinzufügen eines Werts zum Attribut "attributeDisplayNames"

So fügen Sie dem attributDisplayNames Attribut einen Namenszuordnungswert hinzu

  1. Ermitteln Sie, ob der Namenszuordnungswert für das Attribut vorhanden ist. Wenn ein Namenszuordnungswert ersetzt werden soll, wurde zuerst der vorhandene Wert mithilfe der IADs::P utEx--Methode gelöscht, wobei der lnControlCode- Parameter auf ADS_PROPERTY_DELETE festgelegt ist, und der vProp-parameter, der auf den zu entfernenden Wert festgelegt ist. Verwenden Sie ADS_PROPERTY_CLEAR oder ADS_PROPERTY_UPDATE nicht für lnControlCode-.
  2. Erstellen Sie die Zeichenfolge, die den Anzeigenamen des Attributs darstellt. Ein Beispiel finden Sie im obigen Format.
  3. Verwenden Sie die IADs::P utEx--Methode, wobei der lnControlCode Parameter auf ADS_PROPERTY_APPEND festgelegt ist, um den neuen Wert hinzuzufügen.
  4. Rufen Sie IADs::SetInfo auf, um die Änderungen an dem Verzeichnis zu übernehmen.

Weitere Informationen zum Benennen neuer Klassen und Attribute finden Sie unter Naming Attributes and Classes.