Structure MapiMessageW (mapi.h)

Une structure MapiMessageW contient des informations sur un message.

Syntaxe

typedef struct {
  ULONG            ulReserved;
  PWSTR            lpszSubject;
  PWSTR            lpszNoteText;
  PWSTR            lpszMessageType;
  PWSTR            lpszDateReceived;
  PWSTR            lpszConversationID;
  FLAGS            flFlags;
  lpMapiRecipDescW lpOriginator;
  ULONG            nRecipCount;
  lpMapiRecipDescW lpRecips;
  ULONG            nFileCount;
  lpMapiFileDescW  lpFiles;
} MapiMessageW, *lpMapiMessageW;

Membres

ulReserved

Type : ULONG

Réservés au; doit être égal à zéro.

lpszSubject

Type : PWSTR

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, il n’y a pas de texte d’objet.

lpszNoteText

Type : PWSTR

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

Type : PWSTR

Pointeur vers une chaîne qui indique le type de message de lorsque le message n’est pas un ipm.

Si votre client prend en charge les messages interpersonnels (IPM) exclusivement, définissez le membre lpszMessageType sur vide ou NULL lors de l’envoi de messages et ignorez le membre lors de la lecture des messages.

lpszDateReceived

Type : PWSTR

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

lpszConversationID

Type : PWSTR

Pointeur vers une chaîne identifiant le thread de conversation auquel appartient le message. Certains systèmes de messagerie ignorent ce membre.

flFlags

Type : FLAGS

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

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

lpOriginator

Type : lpMapiRecipDescW

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

nRecipCount

Type : ULONG

Nombre de structures MapiRecipDescW dans le tableau vers lequel pointe le membre lpRecips .

Si ce membre est égal à zéro, il n’y a aucun destinataire.

lpRecips

Type : lpMapiRecipDescW

Pointeur vers un tableau de structures MapiRecipDescW . Chaque structure contient des informations sur un destinataire.

nFileCount

Type : ULONG

Nombre de structures MapiFileDescW dans le tableau désigné par le membre lpFiles .

Si ce membre est égal à zéro, il n’y a pas de pièces jointes.

lpFiles

Type : lpMapiFileDescW

Pointeur vers un tableau de structures MapiFileDescW . Chaque structure contient des informations sur une pièce jointe.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	mapi.h

Voir aussi

MAPISendMailW

MapiFileDescW

MapiMessage

MapiRecipDescW