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.LHV0L 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 NOTIFICATION1KRZ0QA 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 events:

fnevObjectCreated

fnevObjectModified

fnevObjectDeleted

fnevObjectMoved

fnevObjectCopied

fnevSearchComplete

 

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

Topic

Description

Event Notification in MAPIE.8REW

General overview of notification and notification events.

Handling Notifications1Q6HBVG

Discussion of how clients should handle notifications.

Using a Support Object for Event Notification2VRG_X4

Discussion of how service providers can use the IMAPISupport method to generate notifications.

 

See Also

NOTIFICATION, SPropTagArray