次の方法で共有

クラスと属性の表示名

  • [アーティクル]

オブジェクト クラスの表示指定子には、そのクラスのオブジェクトの 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. 新しい値を追加するには、lnControlCode パラメーターを ADS_PROPERTY_APPENDIADs::P utEx メソッドを使用します。
  4. IADs::SetInfo を呼び出して、ディレクトリへの変更をコミットします。

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