Important:
This is retired content. 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 content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The EXTENDED_NOTIFICATIONstructure describes information relating to an event that is service provider-specific.

Syntax

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

Members

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 used depends on the value of the ulEventmember; these parameters are documented by the provider that issued the event.

Remarks

This type is supported, but the notification that uses it ( fnevExtended) is never sent by MAPI.

The EXTENDED_NOTIFICATIONstructure is one of the members of the union of structures included in the infomember of the NOTIFICATIONstructure. When the infomember of a NOTIFICATIONstructure contains an EXTENDED_NOTIFICATIONstructure, the ulEventTypemember of the NOTIFICATIONstructure 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 whether a service provider supports an extended event and, if it does, 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::Advisewith the lpEntryIDparameter set to NULLand the cbEntryIDparameter set to zero.

Requirements

Header mapidefs.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

MAPI Structures
NOTIFICATION

Other Resources

Messaging