| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The Select method selects or unselects a toll.
Syntax
HRESULT Select(
BOOL fSelect
);
Parameters
fSelect
[in] Specifies whether to select or unselect the toll. To select the toll, set the value to TRUE. To unselect the toll, set the value to FALSE.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
In order to pay a toll, the user must select it. Only one toll in a collection can be selected at one time. A change in the selection state causes an _ICATollsEvents::StateChanged event.
Exception: The Conditional Access (CA) Manager maintains a collection of unpaid tolls. More than one toll in this collection can be selected, and selecting a toll does not fire an event.
Implementation note: For an unpaid toll, call the ICAToll::get_TolledObject method to retrieve the tolled object. Query the returned pointer for the ICADenial or ICAOffer interface, and call the NotifyStateChanged method on whichever interface is retrieved. (Both interfaces support the method.) The NotifyStateChanged method signals a StateChanged event and unselects the other tolls in the collection. For a paid toll, these steps are not required.
See Also