Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The OBJECT_NOTIFICATIONstructure contains information about an object that has undergone a change, such as being copied or modified.

Syntax 

struct { 
  ULONG 
cbEntryID; 
  LPENTRYID 
lpEntryID; 
  ULONG 
ulObjType; 
  ULONG 
cbParentID; 
  LPENTRYID 
lpParentID; 
  ULONG 
cbOldID; 
  LPENTRYID 
lpOldID; 
  ULONG 
cbOldParentID; 
  LPENTRYID 
lpOldParentID; 
  LPSPropTagArray 
lpPropTagArray; 
} OBJECT_NOTIFICATION;

Members

cbEntryID

Count of bytes in the entry identifier pointed to by lpEntryID.

lpEntryID

Pointer to the entry identifier of the affected object.

ulObjType

Type of object affected. Possible types are:

MAPI_STOREMessage store.

MAPI_FOLDERFolder.

MAPI_MESSAGEMessage.

MAPI_SESSIONSession object.

cbParentID

Count of bytes in the entry identifier pointed to by lpParentID.

lpParentID

Pointer to the entry identifier of the parent of the affected object.

cbOldID

Count of bytes in the entry identifier pointed to by lpOldID.

lpOldID

Pointer to the entry identifier of the original object; can be NULLif the event does not require an original object.

cbOldParentID

Count of bytes in the entry identifier pointed to by the lpOldParentIDmember.

lpOldParentID

Pointer to the entry identifier of the parent of the original object; can be NULL if the event does not require an original object.

lpPropTagArray

Pointer to an SPropTagArraystructure containing the property tags identifying properties affected by the event.

Remarks

The OBJECT_NOTIFICATIONstructure is one of the members of the union of structures included in the infomember of the NOTIFICATIONstructure. When the infomember of a NOTIFICATIONstructure contains an OBJECT_NOTIFICATIONstructure, the ulEventTypemember of the NOTIFICATIONstructure is set to one of the following types of events:

  • fnevObjectCreated

  • fnevObjectModified

  • fnevObjectDeleted

  • fnevObjectMoved

  • fnevObjectCopied

The search complete event, represented by the fnevSearchCompleteevent type, indicates that the initial search of the domain for one search folder has completed.

The cbOldID, lpOldID, cbOldParentID, and lpOldParentIDmembers are used only in move and copy events.

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