OBJECT_NOTIFICATION

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 page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

typedef struct _OBJECT_NOTIFICATION
{
  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 the lpEntryID member.

• lpEntryID
  Pointer to the entry identifier of the affected object.

• ulObjType
  Type of object affected. Possible types are as follows:

  • MAPI_STORE
    Message store.

  • MAPI_ADDRBOOK
    Address book.

  • MAPI_FOLDER
    Folder.

  • MAPI_ABCONT
    Address book container.

  • MAPI_MESSAGE
    Message.

  • MAPI_MAILUSER
    Messaging user.

  • MAPI_ATTACH
    Attachment.

  • MAPI_DISTLIST
    Distribution list.

  • MAPI_PROFSECT
    Profile section.

  • MAPI_STATUS
    Status object.

  • MAPI_SESSION
    Session object.

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

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

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

• lpOldID
  Pointer to the entry identifier of the original object. This pointer 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. This pointer can be NULL if the event does not require an original object.

• lpPropTagArray
  Pointer to an SPropTagArray structure that contains 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

-
fnevSearchComplete

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 following members that contain information about the original object are used only in move and copy events.

-
cbOldID

-
lpOldID

-
cbOldParentID

-
lpOldParentID

These members do not apply to the other types of events.

For more information about notification, see the topics described in the following table.

See Also

Reference

NOTIFICATION

SPropTagArray

Concepts

MAPI Structures