STATUS_OBJECT_NOTIFICATION

The STATUS_OBJECT_NOTIFICATION structure describes a status object that has been affected by a change.

Quick Info

Header file: MAPIDEFS.H

typedef struct 
{ 
     ULONG         cbEntryID; 
     LPENTRYID     lpEntryID; 
     ULONG         cValues; 
     LPSPropValue  lpPropVals; 
} STATUS_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 changed status object.
cValues
Count of SPropValue structures in the array pointed to by the lpPropVals member.
lpPropVals
Pointer to an array of SPropValue structures that describe the properties of the changed status object.

Remarks

The STATUS_OBJECT_NOTIFICATION structure is one of the members of the union of structures included in the info member of the NOTIFICATION structure. The STATUS_OBJECT_NOTIFICATION structure is included with a status object notification — a notification for an event of type fnevStatusObjectModified. Status object notification is an internal MAPI notification; clients and service providers cannot register for it and service providers cannot generate it.

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.
Supporting Event Notification Discussion of how service providers can use the IMAPISupport method to generate notifications.

See Also

Notification Structures, NOTIFICATION, SPropValue