Share via


NEWMAIL_NOTIFICATION

4/8/2010

The NEWMAIL_NOTIFICATION structure describes information relating to the arrival of a new message.

Syntax

struct { 
  ULONG cbEntryID; 
  LPENTRYID lpEntryID; 
  ULONG cbParentID; 
  LPENTRYID lpParentID; 
  ULONG ulFlags; 
  LPTSTR lpszMessageClass; 
  ULONG ulMessageFlags; 
} NEWMAIL_NOTIFICATION; 

Members

  • cbEntryID
    Count of bytes in the entry identifier pointed to by lpEntryID.
  • lpEntryID
    Pointer to the entry identifier of the newly arrived message.
  • cbParentID
    Count of bytes in the entry identifier pointed to by the lpParentID member.
  • lpParentID
    Pointer to the entry identifier of the receive folder for the newly arrived message.
  • ulFlags
    Bitmask of flags used to describe the format of the string properties included with the message. The following flag can be set:

    MAPI_UNICODE

    The passed-in strings are in Unicode format.

  • lpszMessageClass
    Pointer to the message class of the newly arrived message.
  • ulMessageFlags
    Bitmask of flags that describes the current state of the newly arrived message. The ulMessageFlags member is a copy of the message's PR_MESSAGE_FLAGS property.

Remarks

This type is supported, but the notification that uses it (fnevNewMail) is never sent by MAPI.

The NEWMAIL_NOTIFICATION structure is one of the members of the union of structures included in the info member of the NOTIFICATION structure. When the info member of a NOTIFICATION structure contains a NEWMAIL_NOTIFICATION structure, the ulEventType member of the NOTIFICATION structure is set to fnevNewMail*.*

MAPI uses the NEWMAIL_NOTIFICATION structure only as a member of the NOTIFICATION structure, which holds information about a notification event for the advise sink.

Requirements

Header mapidefs.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

MAPI Structures
NOTIFICATION
PR_MESSAGE_FLAGS

Other Resources

Messaging