Dela via


Visningsnamn för klass och attribut

Visningsspecificeraren för en objektklass innehåller följande attribut som kan användas för att ange de lokaliserade visningsnamn som används i användargränssnittet för objekt i den klassen:

  • Attributet classDisplayName är en Unicode-sträng med ett enda värde som anger klassens visningsnamn.
  • Attributet DisplayNames är en egenskap med flera värden som anger de namn som ska användas i användargränssnittet för attribut för objektklassen.

-attributetDisplayNames värden är Unicode-strängar. varje element består av ett kommaavgränsat namnpar:

<attribute name>,<display text>

I det här exemplet är "<attributnamn>" lDAPDisplayName för attributet och "<visningstext>" är den text som ska visas som namnet på attributet i användargränssnittet.

Riktlinjer för visningsnamn för klass och attribut

Eftersom många leverantörer kan utöka klasser med nya attribut eller skapa helt nya klasser är det viktigt att visningsnamnen för klass och attribut är tvetydiga och inte resulterar i konflikter.

Varje leverantör bör prefixa klassens visningsnamn med en unik egen identifierare baserat på leverantörsnamnet. Om till exempel det fiktiva företaget Fabrikam Inc., skapar en ny klass som härleds från klassen "kontakt" kan de ha ett unikt klassvisningsnamn "Fabrikam Contact".

Om en leverantör utökar en befintlig klass med nya attribut bör de återigen unikt identifiera attributets visningsnamn så att inga konflikter uppstår med andra attributvisningsnamn. Återigen är det bra att prefixa attributets visningsnamn med unik användarvänlig identifierare baserat på leverantörsnamnet. Om Fabrikam-företaget till exempel utökar användarklassen med ett nytt HR-attribut kan de unikt visa attributet som "Fabrikam HR Information".

Ur ett lokaliseringsperspektiv bör dessutom varje leverantör lokalisera visningsnamnen för klass och attribut till varje språk som stöds av Windows 2000.

Lägga till ett värde i attributetDisplayNames-attribut

Om du vill lägga till ett namnmappningsvärde i attributet DisplayNames attribut

  1. Kontrollera om värdet för namnmappning för attributet finns. Om ett namnmappningsvärde ska ersättas, tog du först bort det befintliga värdet med hjälp av metoden IAD::P utEx, med parametern lnControlCode inställd på ADS_PROPERTY_DELETE och parametern vProp inställd på det värde som ska tas bort. Använd inte ADS_PROPERTY_CLEAR eller ADS_PROPERTY_UPDATE för lnControlCode.
  2. Skapa strängen som representerar attributets visningsnamn. Ett exempel finns i formatet ovan.
  3. Använd metoden IADs::P utEx med parametern lnControlCode inställd på ADS_PROPERTY_APPEND för att lägga till det nya värdet.
  4. Anropa IAD::SetInfo för att genomföra ändringarna i katalogen.

Mer information om hur du namnger nya klasser och attribut finns i Namngivningsattribut och klasser.