Share via


IMessage::GetRecipientTable

4/8/2010

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

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    Indicates success.
  • 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 Mobile Messaging:

Recipient tables have a different column set depending on whether the message has been submitted.

Requirements

Header mapidefs.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPITable::QueryRows
IMessage
IMessage::ModifyRecipients

Other Resources

Messaging