IIMAPTransport::Capability method

  • Article

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

Returns a value that indicates the capabilities of the Internet Message Access Protocol (IMAP) server.

Syntax

HRESULT Capability(
  [out] DWORD *pdwCapabilityFlags
);

Parameters

pdwCapabilityFlags [out]

Type: DWORD*

Receives a DWORD that indicates which capabilities the IMAP server supports. The result may be one or more of the following values.

Value Meaning
IMAP_CAPABILITY_IMAP4
0x00000001
 Indicates that the server supports the original IMAP4 protocol.
IMAP_CAPABILITY_IMAP4rev1
0x00000002
 Indicates that the server supports the updated version of the IMAP4 protocol.
IMAP_CAPABILITY_IDLE
0x00000004
 Indicate that the server supports real-time updates through the IDLE command.
IMAP_CAPABILITY_ALLFLAGS
0x00000007
 Indicates that all three capabilities are supported by the server.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
 Indicates success.
IXP_E_IMAP_IMPROPER_SVRSTATE
 Indicates that the server is not connected.

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)