IStoreFolder::SaveMessage method

Saves a stream as a new message to the folder associated with the interface.

Syntax

HRESULT SaveMessage(
  [in]  REFIID      riid,
  [in]  LPVOID      pvObject,
  [in]  DWORD       dwMsgFlags,
  [out] LPMESSAGEID pdwMessageId
);

Parameters

riid [in]

Type: REFIID

Specifies the type of stream that pvObject represents. Must be either IID_IStream or IID_IMimeMessage.

pvObject [in]

Type: LPVOID

Pointer to a stream that represents the message body.

dwMsgFlags [in]

Type: DWORD

Specifies a combination of state flags to apply to the message associated with the stream. For a list of flags, see Message State Flags.

pdwMessageId [out]

Type: LPMESSAGEID

Pointer that receives an ID value that identifies the new message.

Return value

Type: HRESULT

Returns S_OK if successful, or the following error value.

Return code	Description
E_INVALIDARG	The value of pvObject is NULL, or the riid parameter is not IID_IStream or IID_IMimeMessage.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Product	Outlook Express 6.0
Header	Msoeapi.h
IDL	Msoeapi.idl
DLL	Inetcomm.dll (version 6.0 or later)