Export (0) Print
Expand All

EXTENDED_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.

Describes information that relates to an event that is service provider-specific.

Header file:

Mapidefs.h

typedef struct _EXTENDED_NOTIFICATION
{
  ULONG ulEvent;
  ULONG cb;
  LPBYTE pbEventParameters;
} EXTENDED_NOTIFICATION;

ulEvent

Extended event code that is defined by the provider.

cb

Count of bytes in the event-specific parameters pointed to by pbEventParameters.

pbEventParameters

Pointer to event-specific parameters. The type of parameters that are used depends on the value of the ulEvent member; these parameters are documented by the provider that issued the event.

The EXTENDED_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 EXTENDED_NOTIFICATION structure, the ulEventType member of the NOTIFICATION structure is set to fnevExtended.

The extended event is defined by a service provider to represent a type of change that cannot be covered by any of the other predefined events. Only clients that know before they register that a service provider supports an extended event can register for that event. It is not possible for clients to determine without advanced knowledge if a service provider supports an extended event. If a service provider supports an extended event, it shows how to handle such an event when it is received.

An extended notification is sent by the session when a client logs off. Register for this notification by calling IMAPISession::Advise with the lpEntryID parameter set to NULL and the cbEntryID parameter set to zero.

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 methods to generate notifications.

Show:
© 2014 Microsoft