次の方法で共有


クラスと属性の表示名

オブジェクト クラスの表示指定子には、そのクラスのオブジェクトの 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 属性に名前マッピング値を追加するには

  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 を呼び出して、ディレクトリに変更をコミットします。

新しいクラスと属性の名前付けの詳細については、「属性とクラスの名前付け」を参照してください。