IMessage::CreateAttach (Compact 7)

3/12/2014

The CreateAttach method creates a new attachment.

Syntax

HRESULT CreateAttach (
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulAttachmentNum,
  LPATTACH FAR * lppAttach
);

Parameters

  • lpInterface
    [in] Ignored.
  • ulFlags
    [in] Ignored.
  • lpulAttachmentNum
    [out] Reference to an index number identifying the newly created attachment. This number is valid only when the message is open.
  • lppAttach
    [out] Reference to the open attachment object.

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

When CreateAttach is called, the new attachment and any properties that are set for it are available immediately.

The attachment number pointed to by lpulAttachmentNum is unique and valid only within the context of the message. That is, two attachments in two different messages can have the same number while two attachments in the same message cannot.

Requirements

Header

mapidefs.h

Library

cemapi.lib

See Also

Reference

IMessage