Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Outlook 2013 | Outlook 2016
MAPI divise les propriétés de message en trois types :
Propriétés du contenu du message.
Propriétés de transmission de messages ou d’enveloppe.
Propriétés du destinataire du message.
Les propriétés de contenu de message décrivent le texte d’un message. Chaque classe de message a son propre ensemble de propriétés de contenu. MAPI définit les propriétés de contenu pour les messages de note et de rapport ; il appartient aux clients et aux fournisseurs de magasins de messages qui gèrent ces classes de messages de définir les propriétés de manière appropriée pour leurs implémentations. PR_BODY (PidTagBody) et PR_RTF_COMPRESSED (PidTagRtfCompressed) sont des exemples de propriétés de contenu pour les messages de note. PR_BODY contient le contenu non mis en forme d’une note, tandis que PR_RTF_COMPRESSED contient la version compressée du contenu mis en forme d’une note. Pour plus d’informations sur les plages d’identificateurs de propriété, consultez Plages d’identificateurs de propriétés.
Pour les nouvelles classes de message, les clients peuvent définir des propriétés spécifiques au contenu de l’une des deux manières suivantes :
En utilisant des identificateurs de propriété dans la plage de propriétés de contenu de la classe de message personnalisée : 0x6800 via 0x7BFF.
En utilisant des propriétés nommées qui ont des identificateurs qui se trouvent dans la 0x8000 par 0xFFFE plage.
La plage d’identificateurs pour les propriétés de contenu de la classe de message personnalisée est disponible pour tout client qui crée une classe de message personnalisée. Par conséquent, un identificateur de propriété dans cette plage peut être utilisé pour plusieurs classes de message. Les utilisateurs de propriétés de cette plage ne peuvent pas faire d’hypothèses quant au comportement des propriétés.
Pour les propriétés nommées, les clients créent un nom qui spécifie un jeu de propriétés et une chaîne de caractères ou une valeur numérique pour chaque nouvelle propriété. Les clients associent ensuite la propriété à un identificateur dans la plage de propriétés nommée. Les utilisateurs des propriétés nommées y accèdent par nom ou identificateur via les méthodes IMAPIProp ::GetIDsFromNames et IMAPIProp ::GetNamesFromIDs .
Les propriétés d’enveloppe fournissent des informations utilisées pour transmettre un message d’un destinataire à un autre. Comme avec les propriétés de contenu de message, il est possible pour les clients ou les fournisseurs de services de définir leurs propres propriétés d’enveloppe pour compléter celles définies par MAPI. Les clients et les fournisseurs de transport définissent les propriétés d’enveloppe définies par MAPI en fonction de la définition fournie par MAPI. Les fournisseurs de transport qui implémentent des fonctionnalités spéciales peuvent définir leurs propres propriétés d’enveloppe pour exposer ces fonctionnalités aux clients. MAPI met de côté une plage d’identificateurs de propriété qui peuvent être utilisés pour ces propriétés spéciales définies par le fournisseur. Les fournisseurs de transport implémentent généralement une page de propriétés spéciale pour afficher ces propriétés et permettre aux clients de les modifier. PR_SUBJECT (PidTagSubject) et PR_MESSAGE_CLASS (PidTagMessageClass) sont des exemples de propriétés d’enveloppe. Pour plus d’informations, consultez Plages d’identificateurs de propriétés.
Les propriétés du destinataire décrivent la destination d’un message envoyé. Un destinataire peut être un utilisateur de messagerie, une liste de distribution ou un ordinateur. Les propriétés du destinataire sont définies par MAPI et définies par les fournisseurs de services. Certaines propriétés de destinataire sont prises en charge par les fournisseurs de carnets d’adresses pour leurs objets d’utilisateur de messagerie et de liste de distribution ; les autres propriétés de destinataire sont prises en charge par les clients, les fournisseurs de magasins de messages ou les fournisseurs de transport. Par exemple, tous les destinataires ont besoin d’une adresse et d’un type d’adresse ; Il s’agit des propriétés gérées par un fournisseur de carnets d’adresses lorsque le destinataire est stocké dans l’un de ses conteneurs. Les destinataires ont également un type , PR_RECIPIENT_TYPE (PidTagRecipientType), qui identifie un destinataire en tant que destinataire principal, copie carbone ou destinataire de copie carbone aveugle.
De nombreuses propriétés de message sont facultatives, ce qui signifie que les clients ne peuvent pas s’attendre à ce qu’elles soient disponibles ou définies sur des valeurs valides. Certaines propriétés de message sont obligatoires, mais disponibles uniquement lorsqu’un message est dans un état particulier. Par exemple, un message nouvellement créé n’a pas besoin d’avoir un identificateur d’entrée tant que le message n’a pas été enregistré, et il n’est pas nécessaire d’avoir une classe de message tant que le message n’est pas prêt à être envoyé. Les clients doivent toujours case activée les résultats de leurs appels IMAPIProp ::GetProps et IMAPIProp ::OpenProperty et avoir des valeurs par défaut prêtes en tant que sauvegarde si une propriété demandée n’est pas disponible.
La plupart des propriétés de message définies par les fournisseurs de services sont en lecture seule pour les clients.