OBJECT_NOTIFICATION

  • Article

Send Feedback

The OBJECT_NOTIFICATION structure 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_STORE
    Message store.

    MAPI_FOLDER
    Folder.

    MAPI_MESSAGE
    Message.

    MAPI_SESSION
    Session 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 NULL if the event does not require an original object.

  • cbOldParentID
    Count of bytes in the entry identifier pointed to by the lpOldParentID member.

  • 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 SPropTagArray structure containing the property tags identifying properties affected by the event.

Remarks

The OBJECT_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 an OBJECT_NOTIFICATION structure, the ulEventType member of the NOTIFICATION structure is set to one of the following types of events:

  • fnevObjectCreated
  • fnevObjectModified
  • fnevObjectDeleted
  • fnevObjectMoved
  • fnevObjectCopied

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

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

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 | SPropTagArray

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.