Estrutura MapiMessage (mapi.h)

Artigo
08/24/2023

Uma estrutura MapiMessage contém informações sobre uma mensagem. Para suporte a Unicode, use a estrutura MapiMessageW .

Sintaxe

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;

Membros

ulReserved

Reservados; deve ser zero ou CP_UTF8. Se CP_UTF8, veja a seguir UTF-8 em vez de cadeias de caracteres ANSI: lpszSubject, lpszNoteText, lpszMessageType, lpszDateReceived, lpszConversationID.

lpszSubject

Ponteiro para a cadeia de caracteres de texto que descreve o assunto da mensagem, normalmente limitado a 256 caracteres ou menos. Se esse membro estiver vazio ou NULL, o usuário não inseriu o texto do assunto.

lpszNoteText

Ponteiro para uma cadeia de caracteres que contém o texto da mensagem. Se esse membro estiver vazio ou NULL, não haverá texto da mensagem.

lpszMessageType

Ponteiro para uma cadeia de caracteres que indica um tipo de mensagem não IPM. Os aplicativos cliente podem selecionar tipos de mensagem para suas mensagens não IPM. Os clientes que dão suporte apenas a mensagens IPM podem ignorar o membro lpszMessageType ao ler mensagens e defini-lo como vazio ou NULL ao enviar mensagens.

lpszDateReceived

Ponteiro para uma cadeia de caracteres que indica a data em que a mensagem foi recebida. O formato é AAAA/MM/DD HH:MM, usando um relógio de 24 horas.

lpszConversationID

Ponteiro para uma cadeia de caracteres que identifica o thread de conversa ao qual a mensagem pertence. Alguns sistemas de mensagens podem ignorar e não retornar esse membro.

flFlags

Máscara de bits de sinalizadores de status de mensagem. Os sinalizadores a seguir podem ser definidos.

Valor	Significado
MAPI_RECEIPT_REQUESTED	Uma notificação de recibo é solicitada. Os aplicativos cliente definem esse sinalizador ao enviar uma mensagem.
MAPI_SENT	A mensagem foi enviada.
MAPI_UNREAD	A mensagem não foi lida.

lpOriginator

Ponteiro para uma estrutura MapiRecipDesc que contém informações sobre o remetente da mensagem.

nRecipCount

O número de estruturas de destinatários de mensagem na matriz apontada pelo membro lpRecips . Um valor zero indica que nenhum destinatário está incluído.

lpRecips

Ponteiro para uma matriz de estruturas MapiRecipDesc , cada uma contendo informações sobre um destinatário da mensagem.

nFileCount

O número de estruturas que descrevem anexos de arquivo na matriz apontada pelo membro lpFiles . Um valor zero indica que nenhum anexo de arquivo está incluído.

lpFiles

Ponteiro para uma matriz de estruturas MapiFileDesc , cada uma contendo informações sobre um anexo de arquivo.