IMessage::GetRecipientTable (Compact 7)
3/12/2014
The GetRecipientTable method returns the message's recipient table.
Syntax
HRESULT GetRecipientTable (
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
)
Parameters
- ulFlags
[in] Ignored.
- lppTable
[out] Reference to the recipient table object implemented on IMAPITable.
Return Value
The GetRecipientTable method returns the following standard HRESULT values.
- S_OK
The operation completed successfully.
- E_FAIL
The operation failed due to an unspecified error.
- E_INVALIDARG
The operation failed because one (or more) of the arguments is not valid.
- E_OUTOFMEMORY
The operation failed because it needs more memory resources.
- E_UNEXPECTED
The operation failed due to an unexpected failure.
- MAPI_E_NO_RECIPIENTS
There are no recipients.
Remarks
GetRecipientTable returns a pointer to the message's recipient table, which includes information about all of the recipients for the message. There is one row for every recipient.
The following IMAPITable methods are supported for recipient tables in Windows Embedded Compact Messaging:
- IMAPITable::QueryRows.
- IMAPITable::SeekRow (however, the lRowCount parameter must equal zero).
- IMAPITable::Restrict.
Recipient tables have a different column set depending on whether the message has been submitted.
The recipient table can be restricted on the property PR_KEYWORD. This property contains the local part of a recipient’s e-mail address.
Requirements
Header |
mapidefs.h |
Library |
cemapi.lib |