| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The ICAOffer interface is supported by offers.
Offers provide 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::get_OkToRemoveOffer method returns TRUE.
In addition to the methods inherited from IDispatch, the ICAOffer interface exposes the following methods.
| Method | Description |
| get_CAManager | Retrieves the Conditional Access (CA) Manager. |
| get_Description | Retrieves a description of the offer. |
| get_EndTime | Retrieves the date and time when the offer expires. |
| get_Policy | Retrieves the policy that created this offer. |
| get_StartTime | Retrieves the date and time when the offer becomes valid. |
| get_Tolls | Retrieves the tolls that can be paid for this offer. |
| NotifyTollStateChanged | Signals that the state of a toll has changed. |
| put_CAManager | Specifies the CA Manager. |
| put_Description | Specifies a description of the offer. |