IIMAPTransport::MsgSeqNumToUID method

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

Returns the unique identifier (UID) that maps to the specified message sequence number in the MsgSeqNumToUID table.

Syntax

HRESULT MsgSeqNumToUID(
  [in]  DWORD dwMsgSeqNum,
  [out] DWORD *pdwUID
);

Parameters

dwMsgSeqNum [in]

Type: DWORD

Specifies a DWORD that contains the message sequence number.

pdwUID [out]

Type: DWORD*

Receives a pointer to a DWORD that contains the UID. Returns zero if no matching UID is found.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
Indicates success.
E_FAIL
Indicates that dwMsgSeqNum is out of range or the MsgSeqNumToUID table doesn't exist.
OLE_E_BLANK
Indicates that there is no matching UID for dwMsgSeqNum.

Remarks

The MsgSeqNumToUID table maps message sequence numbers to unique identifiers (UIDs). If the client uses message sequence numbers exclusively to identify messages to the server, then this method is not required.

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)