Propriété canonique PidTagMessageFlags

Article
03/15/2024

S’applique à : Outlook 2013 | Outlook 2016

Contient un masque de bits d’indicateurs qui indiquent l’origine et l’état actuel d’un message.

Propriété	Valeur
Propriétés associées :	PR_MESSAGE_FLAGS
Identificateur :	0x0E07
Type de données :	PT_LONG
Domaine :	Messagerie générale

Remarques

Cette propriété est une propriété de message nontransmitable exposée aux extrémités d’envoi et de réception d’une transmission, avec des valeurs différentes en fonction de l’application cliente ou du fournisseur de magasin impliqué. Cette propriété est initialisée par le client ou le fournisseur de magasin de messages lorsqu’un message est créé et enregistré pour la première fois, puis mise à jour régulièrement par le fournisseur de magasin de messages, un fournisseur de transport et le spouleur MAPI au fur et à mesure que le message est traité et que son état change.

Cette propriété existe sur un message avant et après l’envoi, ainsi que sur toutes les copies du message reçu. Bien qu’il ne s’agisse pas d’une propriété de destinataire, elle est exposée différemment à chaque destinataire selon qu’elle a été lue ou modifiée par ce destinataire.

Un ou plusieurs des indicateurs suivants peuvent être définis pour cette propriété :

MSGFLAG_ASSOCIATED

Le message est un message associé à un dossier. Le client ou le fournisseur dispose d’un accès en lecture seule à cet indicateur. L’indicateur MSGFLAG_READ est ignoré pour les messages associés, qui ne conservent pas un état lu/non lu.

MSGFLAG_FROMME

L’utilisateur de messagerie envoyant était l’utilisateur de messagerie qui recevait le message. Le client ou le fournisseur dispose d’un accès en lecture/écriture à cet indicateur jusqu’à ce que le premier appel IMAPIProp ::SaveChanges soit ensuite en lecture seule. Cet indicateur est destiné à être défini par le fournisseur de transport.

MSGFLAG_HASATTACH

Le message comporte au moins une pièce jointe. Cet indicateur correspond à la propriété PR_HASATTACH (PidTagHasAttachments) du message. Le client dispose d’un accès en lecture seule à cet indicateur.

MSGFLAG_NRN_PENDING

Un rapport non lu doit être envoyé pour le message. Le client ou le fournisseur dispose d’un accès en lecture seule à cet indicateur.

MSGFLAG_ORIGIN_INTERNET

Le message entrant est arrivé sur Internet. Il provient soit de l’extérieur du organization, soit d’une source que la passerelle ne peut pas considérer comme approuvée. Le client doit afficher un message approprié à l’utilisateur. Les fournisseurs de transport définissent cet indicateur ; le client dispose d’un accès en lecture seule.

MSGFLAG_ORIGIN_MISC_EXT

Le message entrant est arrivé via un lien externe autre que X.400 ou Internet. Il provient soit de l’extérieur du organization, soit d’une source que la passerelle ne peut pas considérer comme approuvée. Le client doit afficher un message approprié à l’utilisateur. Les fournisseurs de transport définissent cet indicateur ; le client dispose d’un accès en lecture seule.

MSGFLAG_ORIGIN_X400

Le message entrant est arrivé via un lien X.400. Il provient soit de l’extérieur du organization, soit d’une source que la passerelle ne peut pas considérer comme approuvée. Le client doit afficher un message approprié à l’utilisateur. Les fournisseurs de transport définissent cet indicateur ; le client dispose d’un accès en lecture seule.

MSGFLAG_ORIGIN_EXT_SEND

Le message provient de l’extérieur du organization. Le client doit afficher un message approprié à l’utilisateur. Les fournisseurs de transport définissent cet indicateur ; le client dispose d’un accès en lecture seule.

MSGFLAG_READ

Le message est marqué comme ayant été lu. Cela peut se produire à tout moment suite à un appel à IMessage ::SetReadFlag ou IMAPIFolder ::SetReadFlags. Les clients peuvent également définir cet indicateur en appelant la méthode IMAPIProp ::SetProps d’un message avant que le message n’ait été enregistré pour la première fois. Cet indicateur est ignoré si l’indicateur MSGFLAG_ASSOCIATED est défini.

MSGFLAG_RESEND

Le message inclut une demande de renvoi d’opération avec un rapport de non-remise. Le client ou le fournisseur dispose d’un accès en lecture/écriture à cet indicateur jusqu’à ce que le premier appel IMAPIProp ::SaveChanges soit ensuite en lecture seule.

MSGFLAG_RN_PENDING

Un rapport de lecture doit être envoyé pour le message. Le client ou le fournisseur dispose d’un accès en lecture seule à cet indicateur.

MSGFLAG_SUBMIT

Le message est marqué pour l’envoi à la suite d’un appel à IMessage ::SubmitMessage. Les fournisseurs de magasins de messages définissent cet indicateur ; le client dispose d’un accès en lecture seule.

MSGFLAG_UNMODIFIED

Le message sortant n’a pas été modifié depuis la première fois qu’il a été enregistré ; le message entrant n’a pas été modifié depuis sa remise.

MSGFLAG_UNSENT

Le message est toujours en cours de rédaction. Il est enregistré, mais n’a pas été envoyé. Le client ou le fournisseur dispose d’un accès en lecture/écriture à cet indicateur jusqu’à ce que le premier appel IMAPIProp ::SaveChanges soit ensuite en lecture seule. Si un client ne définit pas cet indicateur au moment de l’envoi du message, le fournisseur de magasin de messages le définit quand IMessage ::SubmitMessage est appelé. En règle générale, cet indicateur est effacé après l’envoi du message.

Un client ou un fournisseur de magasin de messages peut case activée l’état actuel du message à tout moment en appelant la méthode IMAPIProp ::GetProps pour lire les valeurs d’indicateur. Le client ou le fournisseur peut également appeler la méthode IMAPIProp ::SetProps pour modifier les indicateurs qui disposent actuellement d’un accès en lecture/écriture.

Plusieurs indicateurs sont toujours en lecture seule. Certains sont en lecture/écriture jusqu’au premier appel à la méthode IMAPIProp ::SaveChanges et deviennent ensuite en lecture seule en ce qui concerne IMAPIProp ::SetProps . L’un d’entre eux, MSGFLAG_READ, peut être modifié ultérieurement via IMessage ::SetReadFlag ou IMAPIFolder ::SetReadFlags.

Les valeurs initiales de cette propriété sont généralement MSGFLAG_UNSENT et MSGFLAG_UNMODIFIED pour indiquer un message qui n’a pas encore été envoyé ou modifié. Lorsqu’un message est enregistré pour la deuxième fois, le fournisseur de magasin de messages efface l’indicateur MSGFLAG_UNMODIFIED. Une autre valeur qu’un fournisseur de magasin de messages peut définir lors de l’enregistrement d’un message est l’indicateur MSGFLAG_HASATTACH, indiquant que le message contient une ou plusieurs pièces jointes. La propriété PR_HASATTACH est calculée à partir de ce paramètre.

Lorsqu’un client appelle la méthode IMessage ::SubmitMessage pour envoyer le message, le fournisseur de magasin de messages en effectue une copie pour le spouleur MAPI et met à jour cette propriété en définissant l’indicateur MSGFLAG_SUBMIT. Le fournisseur de la banque de messages définit également MSGFLAG_UNSENT s’il n’est pas encore défini. MSGFLAG_SUBMIT indique que SubmitMessage a été appelé, au début du processus d’envoi, et que le message est désormais en lecture seule pour le client. MSGFLAG_UNSENT indique que le spouleur MAPI gère le message. Si le processus d’envoi est annulé, le fournisseur de la banque de messages réinitialise cet indicateur.

Lorsque le message est remis à un fournisseur de transport pour remise, le fournisseur de transport définit l’indicateur MSGFLAG_FROMME si l’expéditeur avait le même compte sur le serveur de messagerie que celui sur lequel le message a été reçu. Les fournisseurs de transport définissent MSGFLAG_FROMME pour un message entrant envoyé par l’utilisateur actuellement connecté. Un client peut utiliser cette valeur pour déterminer qu’il est plus approprié d’afficher les noms des destinataires dans la table du contenu du dossier Éléments envoyés que les noms d’expéditeurs. Les messages qui ont été enregistrés pendant le processus de composition et qui n’ont pas encore été envoyés doivent également être affichés avec des noms de destinataires plutôt que des noms d’expéditeurs.

Pour un message entrant, un fournisseur de magasin de messages efface l’indicateur MSGFLAG_READ pour réinitialiser son status de lecture. Un client peut définir ou effacer l’indicateur de MSGFLAG_READ lorsqu’il est nécessaire de modifier la status de lecture et de contrôler l’envoi de rapports en lecture et non lus, en appelant la méthode IMessage ::SetReadFlag du message ou la méthode IMAPIFolder ::SetReadFlags de son dossier. La main différence entre ces méthodes, autre que l’objet qui les implémente, est que la méthode folder peut affecter un, plusieurs ou tous les messages du dossier. La méthode de message affecte un seul message.

Un client doit également tester un message entrant pour les indicateurs MSGFLAG_ORIGIN_X400, MSGFLAG_ORIGIN_INTERNET, MSGFLAG_ORIGIN_MISC_EXT et MSGFLAG_ORIGIN_EXT_SEND. Ces indicateurs sont définis par le fournisseur de transport entrant et indiquent que le message est arrivé d’une source que la passerelle ne peut pas considérer comme approuvée. Cela signifie que le message provient soit de l’extérieur du organization, soit en interne, mais d’une station de travail inconnue de la passerelle. Dans tous les cas, l’identité de l’expéditeur peut ne pas être confirmée, et il existe un risque d’introduire un virus informatique dans le organization. Le client doit afficher un message d’avertissement à l’utilisateur et offrir une option de suppression du message sans l’ouvrir.

Les fournisseurs de magasins de messages définissent l’indicateur MSGFLAG_UNMODIFIED pour les messages entrants. MSGFLAG_UNMODIFIED indique qu’aucun message n’a été modifié depuis sa remise. Un client ne peut pas effacer cette valeur une fois qu’elle a été définie par un fournisseur de magasin de messages.