Share via


NEWMAIL_NOTIFICATION

Send Feedback

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

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h

See Also

MAPI Structures | Messaging | NOTIFICATION | PR_MESSAGE_FLAGS

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.