类和属性显示名称
对象类的显示说明符包含以下属性,这些属性可用于为该类的对象指定 UI 中使用的本地化显示名称:
- classDisplayName 属性是一个单值 Unicode 字符串,用于指定类显示名称。
- attributeDisplayNames 属性是一个多值属性,指定要在 UI 中使用的对象类属性的名称。
attributeDisplayNames 值为 Unicode 字符串;每个元素由逗号分隔的名称对组成:
<attribute name>,<display text>
在此示例中,“<属性名称>”是属性的 lDAPDisplayName,“<显示文本>”是要显示为用户界面中该属性名称的文本。
类和属性显示名称指南
由于许多供应商可能会使用新属性扩展类或创建全新的类,因此类和属性显示名称明确且不会导致冲突非常重要。
每个供应商都应使用基于供应商名称的唯一友好标识符为类显示名称添加前缀。 例如,如果虚构公司 Fabrikam Inc.创建派生自“contact”类的新类,则它们可以具有唯一的类显示名称“Fabrikam Contact”。
如果供应商使用新属性扩展现有类,则它们应再次唯一标识属性显示名称,以便不会与其他属性显示名称发生冲突。 同样,最好根据供应商名称为属性显示名称加上唯一友好标识符。 例如,如果 Fabrikam 公司使用新的 HR 属性扩展用户类,他们可以唯一地将属性显示为“Fabrikam HR Information”。
此外,从本地化的角度来看,每个供应商都应将类和属性显示名称本地化为 Windows 2000 支持的每种语言。
向 attributeDisplayNames 属性添加值
将名称映射值添加到 attributeDisplayNames 属性
- 确定属性的名称映射值是否存在。 如果要替换名称映射值,请先使用 IADs::P utEx 方法删除现有值,并将 lnControlCode 参数设置为 ADS_PROPERTY_DELETE,vProp 参数设置为要删除的值。 请勿对 lnControlCode使用 ADS_PROPERTY_CLEAR 或 ADS_PROPERTY_UPDATE。
- 创建表示属性显示名称的字符串。 有关示例,请参阅上面的格式。
- 将 IADs::P utEx 方法与 lnControlCode 参数设置为 ADS_PROPERTY_APPEND 添加新值。
- 调用 IADs::SetInfo 将更改提交到目录。
有关命名新类和属性的详细信息,请参阅 命名属性和类。