Partager via

Structure MapiMessageW (mapi.h)

  • Article

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