IMessage::GetRecipientTable

Article
08/28/2006

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:

QueryRows
SeekRow (however, the lRowCount parameter must equal zero.)

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

Requirements

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h
Library: cemapi.lib

Share via