Share via


IIMAPTransport2::EnableFetchEx method

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

Enables extended support for the FETCH command responses.

Syntax

HRESULT EnableFetchEx(
  [in] DWORD dwFetchExFlags
);

Parameters

dwFetchExFlags [in]

Type: DWORD

Specifies a DWORD that indicates whether to enable the FETCH command extensions. Sets a persisted IMAPTransport flag.

Value Meaning
IMAP_FETCHEX_DISABLE
0x00000000
Disable the FETCH command extensions.
IMAP_FETCHEX_ENABLE
0x00000001
Enable the FETCH command extensions.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

IMAPTransport initializes the persisted flag as IMAP_FETCHEX_DISABLE.

This method enables a larger set of FETCH command responses to be read. Server responses populate into the FETCH_CMD_RESULTS_EX structure when dwFetchExFlags is equal to IMAP_FETCHEX_ENABLE and into the FETCH_CMD_RESULTS structure when dwFetchExFlags is equal to IMAP_FETCHEX_DISABLE. The FETCH_CMD_RESULTS_EX structure can accomodate ENVELOPE response data that the FETCH_CMD_RESULTS structure does not.

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)