IMessage Interface

IID_IMessage

{00020308-0000-0000-C000-000000000046}

The IAttach interface is used to maintain and provide access to the properties of attachments in messages.

This interface inherits from IMAPIProp.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IMAPIProp Methods

Description

GetLastError

Returns a MAPIERROR structure containing information about the previous error.

SaveChanges

Makes permanent any changes made to an object since the last save operation.

GetProps

Retrieves one or more properties.

GetPropList

Returns property tags for all properties.

OpenProperty

Returns a pointer to an interface to be used to access a property.

SetProps

Updates one or more properties.

DeleteProps

Deletes one or more properties.

CopyTo

Copies or moves all properties, except for specifically excluded properties.

CopyProps

Copies or moves selected properties.

GetNamesFromIDs

Provides the property names that correspond to one or more property identifiers.

GetIDsFromNames

Provides the property identifiers that correspond to one or more property names.

IMessage Methods

Description

GetAttachmentTable

Returns the message's attachment table.

OpenAttach

Opens an attachment.

CreateAttach

Creates a new attachment.

DeleteAttach

Deletes an attachment.

GetRecipientTable

Returns the message's recipient table.

ModifyRecipients

Adds, deletes, or modifies message recipients.

SubmitMessage

Saves all changes to the message and marks it as ready for sending.

SetReadFlag

Sets or clears the MSGFLAG_READ flag in the PR_MESSAGE_FLAGS property of the message and manages the sending of read reports.

GetAttachmentTable

FUNCTION IMessage_GetAttachmentTable ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYREF lppTable AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[14] USING IMessage_GetAttachmentTable (pIMessage, ulFlags, lppTable) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OpenAttach

FUNCTION IMessage_OpenAttach ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulAttachmentNum AS DWORD _
, BYREF lpInterface AS GUID _
, BYVAL ulFlags AS DWORD _
, BYREF lppAttach AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[15] USING IMessage_OpenAttach (pIMessage, ulAttachmentNum, lpInterface, ulFlags, lppAttach) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CreateAttach

FUNCTION IMessage_CreateAttach ( _
  BYVAL pIMessage AS DWORD PTR _
, BYREF lpInterface AS GUID _
, BYVAL ulFlags AS DWORD _
, BYREF lpulAttachmentNum AS DWORD _
, BYREF lppAttach AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[16] USING IMessage_CreateAttach (pIMessage, lpInterface, ulFlags, lpulAttachmentNum, lppAttach) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

DeleteAttach

FUNCTION IMessage_DeleteAttach ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulAttachmentNum AS DWORD _
, BYVAL ulUIParam AS DWORD _
, BYVAL lpProgress AS DWORD _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[17] USING IMessage_DeleteAttach (pIMessage, ulAttachmentNum, ulUIParam, lpProgress, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetRecipientTable

FUNCTION IMessage_GetRecipientTable ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYREF lppTable AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[18] USING IMessage_GetRecipientTable (pIMessage, ulFlags, lppTable) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ModifyRecipients

FUNCTION IMessage_ModifyRecipients ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYVAL lpMods AS ADRLIST PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[19] USING IMessage_ModifyRecipients (pIMessage, ulFlags, lpMods) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SubmitMessage

FUNCTION IMessage_SubmitMessage ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[20] USING IMessage_SubmitMessage (pIMessage, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SetReadFlag

FUNCTION IMessage_SetReadFlag ( _
  BYVAL pIMessage AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMessage[21] USING IMessage_SetReadFlag (pIMessage, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION