ICAToll::PayToll

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

The PayToll method initiates payment of the toll.

Syntax

HRESULT PayToll();

Parameters

This method takes no parameters.

Return Values

Returns an HRESULT value. Possible values include the following.

Remarks

This method starts the process of paying the toll. Depending on the implementation, the toll might require further interaction with the user, or some other kind of verification. Examples might include accessing a credit card account, or requesting the user to enter a password.

If payment is not completed, the method returns S_FALSE or an error code.

Successful payment has the following effects:

• The toll is removed from the owning object’s toll collection.
• The toll is copied to the Conditional Access (CA) Manager’s paid toll collection. (If the toll is non-refundable, this step is optional but recommended.)
• The toll’s ICAToll::get_TolledObject method returns NULL.

See Also

• Error and Success Codes
• ICAToll Interface