Share via

IMessage::GetAttachmentTable

  • Article

4/8/2010

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 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.

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

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

IMessage
IMessage::CreateAttach
IMessage::DeleteAttach
IMessage::OpenAttach

Other Resources

Messaging