Structure MapiMessage (mapi.h)

Article
08/24/2023

Une structure MapiMessage contient des informations sur un message. Pour la prise en charge d’Unicode, utilisez la structure MapiMessageW .

Syntaxe

typedef struct {
  ULONG           ulReserved;
  LPSTR           lpszSubject;
  LPSTR           lpszNoteText;
  LPSTR           lpszMessageType;
  LPSTR           lpszDateReceived;
  LPSTR           lpszConversationID;
  FLAGS           flFlags;
  lpMapiRecipDesc lpOriginator;
  ULONG           nRecipCount;
  lpMapiRecipDesc lpRecips;
  ULONG           nFileCount;
  lpMapiFileDesc  lpFiles;
} MapiMessage, *lpMapiMessage;

Membres

ulReserved

Réservés au; doit être égal à zéro ou CP_UTF8. Si CP_UTF8, les éléments suivants sont UTF-8 au lieu des chaînes ANSI : lpszSubject, lpszNoteText, lpszMessageType, lpszDateReceived, lpszConversationID.

lpszSubject

Pointeur vers la chaîne de texte décrivant l’objet du message, généralement limité à 256 caractères ou moins. Si ce membre est vide ou NULL, l’utilisateur n’a pas entré de texte d’objet.

lpszNoteText

Pointeur vers une chaîne contenant le texte du message. Si ce membre est vide ou NULL, il n’y a pas de texte de message.

lpszMessageType

Pointeur vers une chaîne indiquant un type de message non IPM. Les applications clientes peuvent sélectionner des types de messages pour leurs messages non IPM. Les clients qui prennent uniquement en charge les messages IPM peuvent ignorer le membre lpszMessageType lors de la lecture des messages et le définir sur vide ou NULL lors de l’envoi de messages.

lpszDateReceived

Pointeur vers une chaîne indiquant la date de réception du message. Le format est AAAA/MM/JJ HH:MM, à l’aide d’une horloge de 24 heures.

lpszConversationID

Pointeur vers une chaîne identifiant le thread de conversation auquel appartient le message. Certains systèmes de messagerie peuvent ignorer et ne pas renvoyer ce membre.

flFlags

Masque de bits des indicateurs de status de message. Les indicateurs suivants peuvent être définis.

Valeur	Signification
MAPI_RECEIPT_REQUESTED	Une notification de réception est demandée. Les applications clientes définissent cet indicateur lors de l’envoi d’un message.
MAPI_SENT	Le message a été envoyé.
MAPI_UNREAD	Le message n’a pas été lu.

lpOriginator

Pointeur vers une structure MapiRecipDesc contenant des informations sur l’expéditeur du message.

nRecipCount

Nombre de structures de destinataires de message dans le tableau pointé par le membre lpRecips . La valeur zéro indique qu’aucun destinataire n’est inclus.

lpRecips

Pointeur vers un tableau de structures MapiRecipDesc , chacune contenant des informations sur un destinataire de message.

nFileCount

Nombre de structures décrivant les pièces jointes de fichiers dans le tableau désigné par le membre lpFiles . La valeur zéro indique qu’aucune pièce jointe n’est incluse.

lpFiles

Pointeur vers un tableau de structures MapiFileDesc , chacune contenant des informations sur une pièce jointe.