Microsoft DirectX 8.1 (C++)

CAOffer Object

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

The CAOffer object represents an offer, which provides a way for the user to purchase a service in advance. An offer contains a description, a start date, an expiration date, and one or more tolls. To purchase the offer, the user can pay any of the tolls.

If the user purchases an offer, the owning policy stores the paid toll. When the request for the service arrives, the policy retrieves the paid toll and matches it against the request. It is still possible for another policy to deny the request. In that case, the policy should guarantee that the user can refund the toll. (See ICAToll.RefundToll.)

Every offer is managed by a particular policy. The offer cannot be removed unless that policy�s ICAPolicy.OkToRemoveOffer property is TRUE.

Property Description
CAManager Retrieves the Conditional Access (CA) Manager.
Description Retrieves a description of the offer.
EndTime Retrieves the date and time when the offer expires.
Policy Retrieves the policy that created this offer.
StartTime Retrieves the date and time when the offer becomes valid.
Tolls Retrieves the tolls that can be paid for this offer.

Method Description
NotifyTollStateChanged Signals that the state of a toll has changed.