| Microsoft DirectX 8.1 (C++) |
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. |