OBJECT_NOTIFICATION
The OBJECT_NOTIFICATION
structure contains information about an object that has undergone a change,
such as being modified or copied .
Quick Info
Header
file: |
MAPIDEFS.H |
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 of the affected object.
lpEntryID
Pointer to
the entry identifier of the affected object.
ulObjType
Type of
object affected. Possible types are:
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.
MAPI_SESSION
Session.
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 an
original object is not applicable to the event.
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 an original object is not applicable to the event.
lpPropTagArray
Pointer to an
SPropTagArray
Remarks
The OBJECT_NOTIFICATION
structure is one of the members of the union of structures included in the info
member of the NOTIFICATION
fnevObjectCreated
fnevObjectModified
fnevObjectDeleted
fnevObjectMoved
fnevObjectCopied
fnevSearchComplete
For more
information about notification, see the topics described in the following
table.
Topic |
Description |
Event
Notification in MAPI |
General
overview of notification and notification events. |
Handling
Notifications |
Discussion
of how clients should handle notifications. |
Using a
Support Object for Event Notification |
Discussion
of how service providers can use the IMAPISupport method to generate
notifications. |
See Also