Compartir a través de

Nombres para mostrar de clase y atributo

  • Artículo

El especificador de visualización de una clase de objeto contiene los siguientes atributos que se pueden usar para especificar los nombres para mostrar localizados usados en la interfaz de usuario para objetos de esa clase:

  • El atributo classDisplayName es una cadena Unicode de valor único que especifica el nombre para mostrar de la clase.
  • El atributo attributeDisplayNames es una propiedad de varios valores que especifica los nombres que se usarán en la interfaz de usuario para los atributos de la clase de objeto.

Los valores attributeDisplayNames son cadenas Unicode; cada elemento consta de un par de nombres delimitado por comas:

<attribute name>,<display text>

En este ejemplo, "<attribute name>" es lDAPDisplayName del atributo y "<display text>" es el texto que se va a mostrar como el nombre de ese atributo en la interfaz de usuario.

Directrices para los nombres para mostrar de clase y atributo

Dado que muchos proveedores pueden extender clases con nuevos atributos o crear clases completamente nuevas, es importante que los nombres para mostrar de clase y atributo sean inequívocas y no generen conflictos.

Cada proveedor debe anteponer el nombre para mostrar de clase con un identificador descriptivo único basado en el nombre del proveedor. Por ejemplo, si la empresa ficticia Fabrikam Inc., crea una nueva clase derivada de la clase "contact", puede tener un nombre para mostrar de clase único "Fabrikam Contact".

Si un proveedor extiende una clase existente con nuevos atributos, debe identificar de nuevo de forma única el nombre para mostrar del atributo para que no se produzcan conflictos con otros nombres para mostrar de atributo. De nuevo, es recomendable prefijar el nombre para mostrar del atributo con un identificador descriptivo único basado en el nombre del proveedor. Por ejemplo, si la empresa Fabrikam extiende la clase de usuario con un nuevo atributo hr, podría mostrar de forma única el atributo como "Información de RR. HH. de Fabrikam".

Además, desde una perspectiva de localización, cada proveedor debe localizar los nombres para mostrar de clase y atributo en cada idioma compatible con Windows 2000.

Agregar un valor al atributo AttributeDisplayNames

Para agregar un valor de asignación de nombres al atributo attributeDisplayNames

  1. Determine si el valor de asignación de nombres para el atributo existe. Si se va a reemplazar un valor de asignación de nombres, elimine primero el valor existente mediante el método IADs::P utEx , con el parámetro lnControlCode establecido en ADS_PROPERTY_DELETE y el parámetro vProp establecido en el valor que se va a quitar. No use ADS_PROPERTY_CLEAR ni ADS_PROPERTY_UPDATE para lnControlCode.
  2. Cree la cadena que representa el nombre para mostrar del atributo. Para obtener un ejemplo, vea el formato anterior.
  3. Use el método IADs::P utEx con el parámetro lnControlCode establecido en ADS_PROPERTY_APPEND para agregar el nuevo valor.
  4. Llame a IADs::SetInfo para confirmar los cambios en el directorio.

Para obtener más información sobre cómo asignar nombres a nuevas clases y atributos, vea Asignar nombres a atributos y clases.