MapiMessageW 구조체(mapi.h)

MapiMessageW 구조체에는 메시지에 대한 정보가 포함됩니다.

구문

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;

멤버

ulReserved

형식: ULONG

예약; 0이어야 합니다.

lpszSubject

형식: PWSTR

메시지 제목을 설명하는 텍스트 문자열에 대한 포인터로, 일반적으로 256자 이하로 제한됩니다.

이 멤버가 비어 있거나 NULL이면 제목 텍스트가 없습니다.

lpszNoteText

형식: PWSTR

메시지 텍스트가 포함된 문자열에 대한 포인터입니다.

이 멤버가 비어 있거나 NULL이면 메시지 텍스트가 없습니다.

lpszMessageType

형식: PWSTR

메시지가 IPM이 아닌 경우의 메시지 유형을 나타내는 문자열에 대한 포인터입니다.

클라이언트가 IPM(대인 관계 메시지)을 단독으로 지원하는 경우 메시지를 보낼 때 lpszMessageType 멤버를 빈 또는 NULL 로 설정하고 메시지를 읽을 때 멤버를 무시합니다.

lpszDateReceived

형식: PWSTR

메시지를 받은 날짜를 나타내는 문자열에 대한 포인터입니다. 형식은 24시간 클록을 사용하는 YYYY/MM/DDHH:MM입니다.

lpszConversationID

형식: PWSTR

메시지가 속한 대화 스레드를 식별하는 문자열에 대한 포인터입니다. 일부 메시징 시스템은 이 멤버를 무시합니다.

flFlags

형식: FLAGS

메시지 상태 플래그의 비트 마스크입니다. 다음 플래그를 설정할 수 있습니다.

값	의미
MAPI_RECEIPT_REQUESTED 0x00000002	영수증 알림이 요청됩니다. 클라이언트 애플리케이션은 메시지를 보낼 때 이 플래그를 설정합니다.
MAPI_SENT 0x00000004	메시지가 전송되었습니다.
MAPI_UNREAD 0x00000001	메시지를 읽지 않았습니다.

lpOriginator

형식: lpMapiRecipDescW

메시지 보낸 사람 정보를 포함하는 MapiRecipDescW 구조체에 대한 포인터입니다.

nRecipCount

형식: ULONG

lpRecips 멤버가 가리키는 배열의 MapiRecipDescW 구조체 수입니다.

이 멤버가 0이면 받는 사람이 없습니다.

lpRecips

형식: lpMapiRecipDescW

MapiRecipDescW 구조체의 배열에 대한 포인터입니다. 각 구조에는 한 명의 받는 사람에 대한 정보가 포함됩니다.

nFileCount

형식: ULONG

lpFiles 멤버가 가리키는 배열의 MapiFileDescW 구조체 수입니다.

이 멤버가 0이면 파일 첨부 파일이 없습니다.

lpFiles

형식: lpMapiFileDescW

MapiFileDescW 구조체의 배열에 대한 포인터입니다. 각 구조에는 하나의 파일 첨부 파일에 대한 정보가 포함됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
머리글	mapi.h

추가 정보

MAPISendMailW

MapiFileDescW

MapiMessage

MapiRecipDescW