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

See Also

Reference

IMessage
IMAPITable::QueryRows
IMessage::ModifyRecipients