MAPI Message Classes
S’applique à : Outlook 2013 | Outlook 2016
Chaque message a une propriété de classe de message, PR_MESSAGE_CLASS (PidTagMessageClass), qui identifie le type, l’objectif ou le contenu du message. PR_MESSAGE_CLASS est une propriété obligatoire sur tous les nouveaux messages. La classe d’un message détermine le formulaire utilisé pour présenter le message à l’utilisateur et le dossier pour placer les messages entrants.
Les classes de message sont des chaînes de caractères sensibles à la casse qui contiennent des caractères ASCII compris entre 32 et 127 et sont délimitées par des points, mais elles ne peuvent pas se terminer par un point. Chaque chaîne représente un niveau de sous-classification, et il n’existe aucune limite au nombre de niveaux autorisés.
Par exemple, la plupart des messages envoyés et reçus par les applications clientes appartiennent à la classe de messages IPM , une catégorie générale qui décrit tous les messages interpersonnelles (c’est-à-dire, les messages destinés à être lus par un utilisateur humain, plutôt que par programmation par un ordinateur). Les fournisseurs de magasins de messages décrivent plus précisément un message IPM en créant une sous-classe IPM . La sous-classe IPM hérite des propriétés de la classe de message IPM . Les sous-classes de la classe IPM sont nommées en concaténant d’autres chaînes de caractères sur l’identificateur IPM, comme IPM. Remarque pour décrire un message de note et un ipm. Contact pour décrire un message de contact.
Pour gérer l’affichage et la gestion des messages IPM, les clients peuvent utiliser un formulaire standard fourni par MAPI. Pour gérer l’affichage et la gestion des nouvelles classes de messages, en tant que développeur d’applications clientes, vous avez deux options :
Vous pouvez créer un formulaire à l’aide de l’ensemble d’interfaces de formulaire définies par MAPI qu’un client standard peut utiliser.
Vous pouvez écrire votre propre client en implémentant une application autonome complète.
Bien que les clients doivent définir la propriété PR_MESSAGE_CLASS pour chaque message sortant sur une sous-classe ipm ou IPC, le fournisseur de la banque de messages a la responsabilité ultime de la définir. Par conséquent, si un client envoie un message sans définir sa classe de message, le fournisseur de magasin de messages le définit sur la valeur par défaut appropriée pour le type de client approprié. La classe de message par défaut pour les clients de messagerie interpersonnelle est IPM ; la classe de message par défaut pour les clients de communication interprocessus est IPC.
Les classes de message ont une restriction de longueur de 255 caractères. Toutefois, les classes de message ne doivent pas dépasser 127 caractères pour prendre en charge les classes de message utilisées dans les rapports. Les classes de message de rapport sont basées sur la classe du message d’origine, avec deux ajouts : un préfixe et un suffixe. Le préfixe REPORT indique que le message est un rapport, et le suffixe indique le type de rapport : dr (rapport de remise), NDR (rapport non remis), IPNRN (rapport de lecture) ou IPNNRN (rapport non lu). Notez que ces restrictions de longueur sont indiquées en caractères ; sur les plateformes qui utilisent un jeu de caractères codés sur deux octets, le nombre d’octets réel peut être plus élevé.
Les fournisseurs de magasins de messages doivent retourner MAPI_E_INVALID_PARAMETER à partir de leurs implémentations de méthode IMAPIProp ::SetProps lorsqu’un client tente d’attribuer une chaîne qui dépasse la limite autorisée pour sa classe de message.