共用方式為

類別和屬性顯示名稱

  • 發行項

物件類別的顯示規範包含下列屬性，可用來指定該類別物件的UI中使用的當地語系化顯示名稱：

  • classDisplayName 屬性是單一值 Unicode 字串，指定類別顯示名稱。
  • attributeDisplayNames 屬性是一個多重值屬性，指定要用於物件類別屬性之 UI 中的名稱。

attributeDisplayNames 值是 Unicode 字串;每個元素都包含逗號分隔名稱組：

<attribute name>,<display text>

在此範例中，「<屬性名稱>」 是 屬性的 lDAPDisplayName ，而 「<display text>」 是要顯示為使用者介面中該屬性名稱的文字。

類別和屬性顯示名稱的指導方針

由於許多廠商可能會使用新的屬性來擴充類別，或建立全新的類別，因此類別和屬性顯示名稱必須明確且不會產生衝突。

每個廠商都應該根據廠商名稱，在類別顯示名稱前面加上唯一易記標識碼。 例如，如果虛構的公司 Fabrikam Inc.建立衍生自 “contact” 類別的新類別，他們可以有唯一的類別顯示名稱 “Fabrikam Contact”。

如果廠商使用新的屬性擴充現有的類別，它們應該再次唯一識別屬性顯示名稱，讓其他屬性顯示名稱不會發生任何衝突。 同樣地，根據廠商名稱，在屬性顯示名稱前面加上唯一易記標識碼是很好的作法。 例如，如果 Fabrikam 公司使用新的 HR 屬性擴充使用者類別，他們可以唯一地將屬性顯示為 “Fabrikam HR Information”。

此外，從本地化的觀點來看，每個廠商都應該將類別和屬性顯示名稱當地語系化為 Windows 2000 支援的每個語言。

將 Value 新增至 attributeDisplayNames 屬性

將名稱對應值新增至 attributeDisplayNames 屬性

  1. 判斷屬性的名稱對應值是否存在。 如果要取代名稱對應值，請先使用 IADs：:P utEx 方法刪除現有的值，並將 lnControlCode 參數設定為 ADS_PROPERTY_DELETE，並將 vProp 參數設定為要移除的值。 請勿針對 lnControlCode 使用ADS_PROPERTY_CLEAR或ADS_PROPERTY_UPDATE。
  2. 建立表示屬性顯示名稱的字串。 如需範例，請參閱上述格式。
  3. 使用 IADs：:P utEx 方法，並將 lnControlCode 參數設定為 ADS_PROPERTY_APPEND 以新增值。
  4. 呼叫 IADs：：SetInfo 以認可目錄的變更。

如需命名新類別和屬性的詳細資訊，請參閱 命名屬性和類別。