ICAToll::RefundToll

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

The RefundToll method refunds a paid toll.

Syntax

HRESULT RefundToll();

Parameters

This method takes no parameters.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

To determine whether the toll is refundable, call the ICAToll::get_Refundable method. A toll should be refundable at least until the user accesses the service. Anything further is at the discretion of the policy.

When this method is called, the toll’s ICAPolicy pointer might be NULL. For example, the Conditional Access (CA) Manager might load the toll from persistent storage. The implementation must be prepared to handle this case. Possible strategies include the following:

• The toll loads the policy from storage. (If so, it should add the policy to the CA Manager’s policies collection.)
• The toll communicates directly to a shared database.
• The method simply fails. For example, if the policy is implemented on a smart card and the user removes the card, the toll might be unable to process the refund.

See Also

• ICAToll Interface