Anzeigenamen für Klassen und Attribute

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

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

Die attributeDisplayNames-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 " ist 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 Anzeigenamen der Klassen und Attribute eindeutig sind und keine Konflikte verursachen.

Jeder Anbieter sollte dem Klassenanzeigenamen einen eindeutigen Anzeigebezeichner basierend auf dem Herstellernamen voranstellen. Wenn beispielsweise das fiktive Unternehmen Fabrikam Inc. eine neue Klasse erstellt, die von der Klasse "contact" abgeleitet ist, kann es einen eindeutigen Klassenanzeigenamen "Fabrikam Contact" haben.

Wenn ein Anbieter eine vorhandene Klasse um neue Attribute erweitert, sollte er den Anzeigenamen des Attributs erneut eindeutig identifizieren, sodass keine Konflikte mit anderen Attributanzeigenamen auftreten. Auch hier ist es eine bewährte Methode, dem Anzeigenamen des Attributs einen eindeutigen Anzeigebezeichner basierend auf dem Herstellernamen voranstellen. Wenn beispielsweise das Fabrikam-Unternehmen die Benutzerklasse um ein neues HR-Attribut erweitert, kann das Attribut eindeutig als "Fabrikam HR Information" angezeigt werden.

Darüber hinaus sollte jeder Anbieter aus Lokalisierungssicht die Anzeigenamen der Klassen und Attribute in jede Sprache lokalisieren, die von Windows 2000 unterstützt wird.

Hinzufügen eines Werts zum AttributDisplayNames-Attribut

So fügen Sie dem attributDisplayNames-Attribut einen Wert für die Namenszuordnung hinzu

  1. Bestimmen Sie, ob der Wert für die Namenszuordnung für das Attribut vorhanden ist. Wenn ein Wert für die Namenszuordnung ersetzt werden soll, löschen Sie zuerst den vorhandenen Wert mithilfe der IADs::P utEx-Methode, wobei der lnControlCode-Parameter auf ADS PROPERTY _ _ DELETE und der vProp-Parameter 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 das Verzeichnis zu committen.

Weitere Informationen zum Benennen neuer Klassen und Attribute finden Sie unter Benennen von Attributen und Klassen.