ICAManager::get_Offers

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

The get_Offers method retrieves the available offers.

Syntax

HRESULT get_Offers(
  ICAOffers**  ppOffers
);

Parameters

  ppOffers

[out]  Pointer to a variable that receives an ICAOffers interface pointer.

Return Values

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

Remarks

Offers enable a user to pay for services in advance. An offer contains a description of the service and a set of one or more tolls. If the user decides to pay the toll, the associated policy stores that information.

This method returns a pointer to the ICAOffers collection interface, which the caller can use to enumerate the offers. The collection might be empty.

The returned ICAOffers interface has an outstanding reference count. The caller must release the interface.

See Also

• ICAManager Interface