IMessage::GetAttachmentTable

Article
08/28/2006

The GetAttachmentTable method returns the message's attachment table.

Syntax

HRESULT GetAttachmentTable (
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

Parameters

ulFlags
[in] Ignored.
lppTable
[out] Reference to the attachment table object implemented on IMAPITable.

Return Values

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

S_OK
Indicates success.

Remarks

GetAttachmentTable returns a pointer to the message's attachment table, which includes information about all of the attachments in the message. Clients can get access to an attachment only through the attachment table. By retrieving an attachment's number, a client can use several of the IMessage methods to work with the attachment. There is one row for each attachment.

The following IMAPITable methods are supported for attachment tables in Windows Mobile Messaging:

Attachment tables are dynamic. Some attachment tables support a wide variety of restrictions. Support for restrictions depends on the message store provider's implementation.

When initially opened, attachment tables are not necessarily sorted in any particular order.

Requirements

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