NAME

MAPIFindNext  (MAPI32.214)

SYNOPSIS

 ULONG MAPIFindNext
 (
  LHANDLE   lhSession,
  ULONG_PTR ulUIParam,
  LPSTR     lpszMessageType,
  LPSTR     lpszSeedMessageID,
  FLAGS     flFlags,
  ULONG     ulReserved,
  LPSTR     lpszMessageID
 )

DESCRIPTION

Enumerate messages of a given type. It returns message identifiers that can be used in subsequent MAPI function calls to retrieve and delete messages. MAPIFindNext is for processing incoming mail, not for managing received mail. MAPIFindNext looks for messages in the folder in which new messages of the specified type are delivered.

PARAMS

lhSession [In] Session handle that represents a Simple MAPI session. The value of the lhSession parameter must represent a valid session; it cannot be zero.
ulUIParam [In] Parent window handle or zero, indicating that if a dialog box is displayed, it is application modal. If the ulUIParam parameter contains a parent window handle, it is of type HWND (cast to a ULONG). If no dialog box is displayed during the call, ulUIParam is ignored.
lpszMessageType [In] Pointer to a string identifying the message class to search. To find an interpersonal message (IPM), specify NULL in the lpszMessageType parameter or have it point to an empty string. Messaging systems whose only supported message class is IPM can ignore this parameter.
lpszSeedMessageID [In] Pointer to a string containing the message identifier seed for the request. If the lpszSeedMessageID parameter is NULL or points to an empty string, MAPIFindNext retrieves the first message that matches the type specified in the lpszMessageType parameter.
flFlags [In] Bitmask of option flags. The following flags can be set:.
MAPI_GUARANTEE_FIFO - not realized
MAPI_LONG_MSGID - not realized
MAPI_UNREAD_ONLY - not realized
ulReserved [In] Reserved; must be zero.
lpszMessageID [Out] Pointer to the returned message identifier. The caller is responsible.
for allocating the memory. To ensure compatibility, allocate 512
characters and set MAPI_LONG_MSGID in the flFlags parameter.
A smaller buffer is sufficient only if the returned message identifier
is always 64 characters or less.

RETURNS

MAPI_E_FAILURE One or more unspecified errors occurred while looking for messages. MAPI_E_INSUFFICIENT_MEMORY Not enough memory to proceed. MAPI_E_INVALID_MESSAGE The message Id of lpszSeedMessageID was invalid. MAPI_E_INVALID_SESSION An invalid session handle was used for the lhSession parameter. MAPI_E_NO_MESSAGES MAPIFindNext couldn't find a matching message MAPI_E_USER_ABORT The user cancelled the process. SUCCESS_SUCCESS OK.

IMPLEMENTATION

Defined in "mapi.h".

Implemented in "dlls/mapi32/mapi32_main.c". source.winehq.org/source/dlls/mapi32/mapi32_main.c

Debug channel "mapi".


Copyright © 2006 The Wine Project. All trademarks are the property of their respective owners. Visit WineHQ for license details. Generated Oct 2006.