MapiRecipDesc (Simple MAPI)
A MapiRecipDesc structure contains information about a message sender or recipient.
Quick Info
typedef struct {
ULONG ulReserved
ULONG ulRecipClass;
LPTSTR lpszName;
LPTSTR lpszAddress;
ULONG ulEIDSize;
LPVOID lpEntryID;
} MapiRecipDesc, FAR *lpMapiRecipDesc;
Members
-
ulReserved
-
Reserved; must be zero.
-
ulRecipClass
-
Contains a numeric value that indicates the type of recipient. Possible values are:
Value |
Constant |
Meaning |
0 |
MAPI_ORIG |
Indicates the original sender of the message. |
1 |
MAPI_TO |
Indicates a primary message recipient. |
2 |
MAPI_CC |
Indicates a recipient of a message copy. |
3 |
MAPI_BCC |
Indicates a recipient of a blind copy. |
-
lpszName
-
Pointer to the display name of the message recipient or sender.
-
lpszAddress
-
Optional pointer to the recipient or sender's address; this address is provider-specific message delivery data. Generally, the messaging system provides such addresses for inbound messages. For outbound messages, the lpszAddress member can point to an address entered by the user for a recipient not in an address book (that is, a custom recipient).
The format of an address pointed to by the lpszAddress member is [address type][e-mail address]. Examples of valid addresses are FAX:206-555-1212 and SMTP:M@X.COM.
-
ulEIDSize
-
The size, in bytes, of the entry identifier pointed to by the lpEntryID member.
-
lpEntryID
-
Pointer to an opaque entry identifier used by a messaging system service provider to identify the message recipient. Entry identifiers have meaning only for the service provider; client applications will not be able to decipher them. The messaging system uses this member to return valid entry identifiers for all recipients or senders listed in the address book.