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

See Also

Reference

MAPI Structures
NOTIFICATION
PR_MESSAGE_FLAGS

Other Resources

Messaging