Share via

NEWMAIL_NOTIFICATION (Compact 7)

  • Article

3/12/2014

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

See Also

Reference

MAPI Structures
NOTIFICATION
PR_MESSAGE_FLAGS