IMessage::GetRecipientTable

  • Article

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

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

See Also

IMAPITable::QueryRows

IMessage

IMessage::ModifyRecipients

Messaging

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.