Información general sobre MAPI (propiedad)
Hace referencia a: Outlook 2013 | Outlook 2016
Una propiedad es un atributo de un objeto MAPI. Las propiedades describen algo sobre el objeto, como la línea de asunto de un mensaje o el tipo de dirección de un usuario de mensajería. MAPI define muchas propiedades, algunas para describir muchos objetos y otras que son adecuadas solo para un objeto de un tipo determinado. Los clientes y proveedores de servicios pueden ampliar el conjunto de propiedades predefinidas de MAPI mediante la creación de nuevas propiedades personalizadas. Los clientes pueden definir propiedades para describir nuevas clases de mensajes y los proveedores de servicios pueden definir propiedades para exponer las características únicas de su sistema de mensajería.
Las propiedades pueden ser persistentes o temporales. Las propiedades que se conservan de la sesión a la sesión se pueden almacenar con los datos de sus objetos o en el perfil. Las propiedades temporales solo existen durante la sesión actual.
Los clientes y proveedores de servicios pueden mostrar propiedades a los usuarios con una tabla o una hoja de propiedades. Las tablas proporcionan a los usuarios una vista de solo lectura de algunas de las propiedades que pertenecen a varios objetos. Los datos se muestran en formato de fila y columna, con cada fila que representa un objeto y cada columna una propiedad. Las hojas de propiedades son cuadros de diálogo con pestañas que muestran propiedades relacionadas para un solo objeto. Las hojas de propiedades pueden proporcionar acceso de solo lectura o lectura y escritura a los datos. Si un usuario puede realizar cambios o no depende del implementador de la hoja de propiedades.
La interfaz IMAPIProp es la interfaz principal para trabajar con propiedades. Todos los objetos que admiten propiedades implementan IMAPIProp. IMAPIProp incluye métodos para recuperar valores de propiedad, copiar propiedades, realizar cambios y guardar esos cambios, asignar entre nombres de propiedad y sus identificadores y recuperar información sobre un error anterior.
Hay varias estructuras de datos para describir propiedades e información sobre las propiedades. Las estructuras más usadas son la estructura SPropValue y la estructura SPropTagArray . La estructura SPropValue contiene los tres elementos de información que describen una propiedad:
Datos, o valor, de la propiedad .
Tipo de datos del valor de la propiedad, como entero o booleano.
Valor numérico dentro de un intervalo determinado que identifica de forma única la propiedad y el componente responsables de su mantenimiento. Por ejemplo, hay un intervalo para contener las propiedades de contenido del mensaje definidas por MAPI y otro intervalo para contener las propiedades de contenido del mensaje definidas por un cliente para una clase de mensaje personalizada.
El tipo de propiedad y el identificador se combinan en un único componente denominado etiqueta de propiedad. Las etiquetas de propiedad son constantes que se pueden usar para hacer referencia fácilmente a la propiedad . Las etiquetas de propiedad de las propiedades definidas por MAPI se incluyen en MAPITAGS. Archivo de encabezado H y en el miembro ulPropTag de una estructura SPropValue . Los clientes y proveedores de servicios usan etiquetas de propiedad para identificar, recuperar y actualizar las propiedades correspondientes.
La estructura SPropTagArray es una matriz contada de etiquetas de propiedad. Muchos de los métodos de IMAPIProp y otras interfaces usan una estructura SPropTagArray para describir las propiedades.