Nazwy wyświetlane klas i atrybutów
Specyfikator wyświetlania klasy obiektów zawiera następujące atrybuty, których można użyć do określenia zlokalizowanych nazw wyświetlanych używanych w interfejsie użytkownika dla obiektów tej klasy:
- Atrybut classDisplayName jest ciągiem Unicode o pojedynczej wartości, który określa nazwę wyświetlaną klasy.
- Atrybut DisplayNames jest właściwością wielowartościową określającą nazwy używane w interfejsie użytkownika dla atrybutów klasy obiektu.
Atrybut DisplayNames wartości to ciągi Unicode; każdy element składa się z pary nazw rozdzielanych przecinkami:
<attribute name>,<display text>
W tym przykładzie "<nazwa atrybutu>" jest lDAPDisplayName atrybutu i "<wyświetlania tekstu>" jest tekstem, który ma być wyświetlany jako nazwa tego atrybutu w interfejsie użytkownika.
Wskazówki dotyczące nazw wyświetlanych klas i atrybutów
Ponieważ wielu dostawców może rozszerzać klasy o nowe atrybuty lub tworzyć całkowicie nowe klasy, ważne jest, aby nazwy wyświetlane klas i atrybutów są jednoznaczne i nie powodują konfliktów.
Każdy dostawca powinien prefiks nazwy wyświetlanej klasy o unikatowym przyjaznym identyfikatorze na podstawie nazwy dostawcy. Jeśli na przykład fikcyjna firma Fabrikam Inc. tworzy nową klasę pochodzącą z klasy "contact", może mieć unikatową nazwę wyświetlaną klasy "Fabrikam Contact".
Jeśli dostawca rozszerza istniejącą klasę o nowe atrybuty, powinien ponownie jednoznacznie zidentyfikować nazwę wyświetlaną atrybutu, aby nie wystąpiły konflikty z innymi nazwami wyświetlanymi atrybutów. Ponownie prefiks nazwy wyświetlanej atrybutu z unikatowym przyjaznym identyfikatorem na podstawie nazwy dostawcy jest dobrym rozwiązaniem. Jeśli na przykład firma Fabrikam rozszerza klasę użytkownika przy użyciu nowego atrybutu HR, może unikatowo wyświetlić atrybut "Fabrikam HR Information".
Ponadto z perspektywy lokalizacji każdy dostawca powinien lokalizować nazwy wyświetlane klas i atrybutów w każdym języku obsługiwanym przez system Windows 2000.
Dodawanie wartości do atrybutuDisplayNames Atrybut
Aby dodać wartość mapowania nazw do atrybutu DisplayNames atrybutu
- Ustal, czy istnieje wartość mapowania nazw dla atrybutu. Jeśli ma zostać zamieniona wartość mapowania nazw, najpierw usunięto istniejącą wartość przy użyciu identyfikatorów IADs::P utEx metodę z parametrem lnControl Code ustawionym na ADS_PROPERTY_DELETE i parametrem vProp ustawionym na wartość do usunięcia. Nie używaj ADS_PROPERTY_CLEAR ani ADS_PROPERTY_UPDATE dla lnControlCode.
- Utwórz ciąg reprezentujący nazwę wyświetlaną atrybutu. Aby zapoznać się z przykładem, zobacz powyższy format.
- Użyj metody IADs::P utEx z parametrem lnControlCode ustawionym na ADS_PROPERTY_APPEND, aby dodać nową wartość.
- Wywołaj IADs::SetInfo, aby zatwierdzić zmiany w katalogu.
Aby uzyskać więcej informacji na temat nazewnictwa nowych klas i atrybutów, zobacz Naming Attributes and Classes.