IMessage::GetAttachmentTable (Compact 7)

  • Article

3/12/2014

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 Embedded Compact 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

See Also

Reference

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