ICATolls::Add

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

The Add method adds a toll to the collection.

Syntax

HRESULT Add(
  ICAToll*  pToll
);

Parameters

  pToll

[in]  Pointer to the ICAToll interface of the toll.

Return Values

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

Remarks

For the toll to be valid, one of the following must be true:

• It was initialized with a tolled object during the ICAPolicy::CheckRequest method.
• It is a paid toll; that is, ICAToll::get_TimePaid returns a non-zero value.

Adding a toll triggers an _ICATollsEvents::ItemAdded event.

See Also

• ICATolls Interface
• ICATolls::Remove