Estrutura MapiMessageW (mapi.h)

  • Artigo

Uma estrutura MapiMessageW contém informações sobre uma mensagem.

Sintaxe

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;

Membros

ulReserved

Tipo: ULONG

Reservados; deve ser zero.

lpszSubject

Tipo: PWSTR

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, não haverá nenhum texto de assunto.

lpszNoteText

Tipo: PWSTR

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

Tipo: PWSTR

Ponteiro para uma cadeia de caracteres que indica o tipo de mensagem de quando a mensagem não é um IPM.

Se o cliente der suporte exclusivo a IPMs (Mensagens Interpessoais), defina o membro lpszMessageType como vazio ou NULL ao enviar mensagens e ignore o membro ao ler mensagens.

lpszDateReceived

Tipo: PWSTR

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

lpszConversationID

Tipo: PWSTR

Ponteiro para uma cadeia de caracteres que identifica o thread de conversa ao qual a mensagem pertence. Alguns sistemas de mensagens ignoram esse membro.

flFlags

Tipo: FLAGS

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

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

lpOriginator

Tipo: lpMapiRecipDescW

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

nRecipCount

Tipo: ULONG

O número de estruturas MapiRecipDescW na matriz apontada pelo membro lpRecips .

Se esse membro for zero, não haverá destinatários.

lpRecips

Tipo: lpMapiRecipDescW

Ponteiro para uma matriz de estruturas MapiRecipDescW . Cada estrutura contém informações sobre um destinatário.

nFileCount

Tipo: ULONG

O número de estruturas MapiFileDescW na matriz apontada pelo membro lpFiles .

Se esse membro for zero, não haverá anexos de arquivo.

lpFiles

Tipo: lpMapiFileDescW

Ponteiro para uma matriz de estruturas MapiFileDescW . Cada estrutura contém informações sobre um anexo de arquivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho mapi.h

Confira também

MAPISendMailW

MapiFileDescW

MapiMessage

MapiRecipDescW