IIMAPTransport::Append method

[IIMAPTransport::Append is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Sends the APPEND command to the Internet Message Access Protocol (IMAP) server.

Syntax

HRESULT Append(
  [in] WPARAM        wParam,
  [in] LPARAM        lParam,
  [in] IIMAPCallback *pCBHandler,
  [in] LPCSTR        lpszMailboxName,
  [in] LPCSTR        lpszMessageFlags,
  [in] FILETIME      ftMessageDateTime,
  [in] LPSTREAM      lpstmMessageToSave
);

Parameters

wParam [in]

Type: WPARAM

Specifies a WPARAM that together with lParam forms a unique transaction ID assigned by the caller to this IMAP command and its responses. The value can be anything except zero, which is reserved for unsolicited responses.

lParam [in]

Type: LPARAM

Specifies an LPARAM that together with wParam forms a unique transaction ID assigned by the caller to this IMAP command and its responses. The value can be anything except zero, which is reserved for unsolicited responses.

pCBHandler [in]

Type: IIMAPCallback*

Specifies a pointer to the IIMAPCallback interface to use to process the responses for this command. If this parameter is NULL, then the default callback interface is used. The default callback interface is specified in the IIMAPTransport::InitNew method, which initialized this IIMAPTransport object.

lpszMailboxName [in]

Type: LPCSTR

Specifies an LPCSTR that contains the IMAP-compliant mailbox name as a multibyte string.

lpszMessageFlags [in]

Type: LPCSTR

Specifies an LPCSTR that contains an IMAP-compliant list of message flags to set for message. Set this parameter to NULL to indicate no message flags. See IMAP_MSGFLAGS for a list of flags; use the message flag names described, not the constants.

ftMessageDateTime [in]

Type: FILETIME

Specifies the date and time (Greenwich Mean Time (GMT)/UTC) to associate with the message.

lpstmMessageToSave [in]

Type: LPSTREAM

Specifies a stream that contains the message to save in RFC 822 format.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
S_OK	Indicates success.
E_FAIL	Indicates that an unknown error has occurred.
E_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.
IXP_E_IMAP_IMPROPER_SVRSTATE	Indicates that the server is not in an authenticated state and cannot accept this command.

Requirements

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