Guide Store Events (C++)

This topic applies to Windows XP Home Edition and Windows XP Professional only.

An application can elect to receive events when objects in the Guide Store repository are added, changed, or removed. To do this, the application implements a callback interface for the collection. For example, to receive events pertaining to the ScheduleEntries collection, the application implements IScheduleEntriesEvents. If the Guide Store cannot obtain this interface, it does not signal events for that collection.

For information on establishing the connection between the Guide Store collection object and your implementation of the events interface, see the Connectable Objects topic in the Platform SDK documentation.

The following table identifies the callback interface for the various collections obtainable from the IGuideStore interface.

Events are not signaled when two or more changes to a collection are made at the conclusion of a transaction; that is, by batch processing. For more information on transactions, see the following topics:

• IGuideStore::BeginTrans
• IGuideStore::CommitTrans
• IGuideStore::RollbackTrans