Vue d’ensemble de la propriété MAPI
S’applique à : Outlook 2013 | Outlook 2016
Une propriété est un attribut d’un objet MAPI. Les propriétés décrivent quelque chose sur l’objet, comme la ligne d’objet d’un message ou le type d’adresse d’un utilisateur de messagerie. MAPI définit de nombreuses propriétés, certaines pour décrire de nombreux objets et d’autres qui conviennent uniquement à un objet d’un type particulier. Les clients et les fournisseurs de services peuvent étendre l’ensemble de propriétés prédéfinies de MAPI en créant des propriétés personnalisées. Les clients peuvent définir des propriétés pour décrire de nouvelles classes de message, et les fournisseurs de services peuvent définir des propriétés pour exposer les fonctionnalités uniques de leur système de messagerie.
Les propriétés peuvent être persistantes ou temporaires. Les propriétés qui persistent d’une session à l’autre peuvent être stockées avec les données de leurs objets ou dans le profil. Les propriétés temporaires existent uniquement pendant la durée de la session active.
Les clients et les fournisseurs de services peuvent afficher les propriétés aux utilisateurs avec une table ou une feuille de propriétés. Les tables fournissent aux utilisateurs une vue en lecture seule de certaines des propriétés appartenant à plusieurs objets. Les données sont affichées au format ligne et colonne, chaque ligne représentant un objet et chaque colonne une propriété. Les feuilles de propriétés sont des boîtes de dialogue à onglets qui affichent les propriétés associées pour un seul objet. Les feuilles de propriétés peuvent fournir un accès en lecture seule ou en lecture/écriture aux données. Le fait qu’un utilisateur soit autorisé ou non à apporter des modifications incombe à l’implémenteur de la feuille de propriétés.
L’interface IMAPIProp est l’interface principale pour l’utilisation des propriétés. Tous les objets qui prennent en charge les propriétés implémentent IMAPIProp. IMAPIProp inclut des méthodes permettant de récupérer des valeurs de propriété, de copier des propriétés, d’apporter des modifications et d’enregistrer ces modifications, de mapper entre les noms de propriétés et leurs identificateurs, et de récupérer des informations sur une erreur précédente.
Il existe plusieurs structures de données pour décrire les propriétés et les informations relatives aux propriétés. Les structures les plus couramment utilisées sont la structure SPropValue et la structure SPropTagArray . La structure SPropValue contient les trois éléments d’informations qui décrivent une propriété :
Données, ou valeur, de la propriété .
Type de données de la valeur de la propriété, par exemple entier ou booléen.
Valeur numérique dans une plage particulière qui identifie de manière unique la propriété et le composant responsable de sa maintenance. Par exemple, il existe une plage pour contenir les propriétés de contenu de message définies par MAPI et une autre plage pour contenir les propriétés de contenu de message définies par un client pour une classe de message personnalisée.
Le type de propriété et l’identificateur sont combinés en un seul composant appelé balise de propriété. Les balises de propriété sont des constantes qui peuvent être utilisées pour faire facilement référence à la propriété . Les balises de propriété pour les propriétés définies par MAPI sont incluses dans mapITAGS. Fichier d’en-tête H et dans le membre ulPropTag d’une structure SPropValue . Les clients et les fournisseurs de services utilisent des balises de propriété pour identifier, récupérer et mettre à jour les propriétés correspondantes.
La structure SPropTagArray est un tableau de balises de propriété comptées. La plupart des méthodes dans IMAPIProp et d’autres interfaces utilisent une structure SPropTagArray pour décrire les propriétés.