ICAOffers::get_AddNew

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

The get_AddNew method creates a new offer and adds it to the collection.

Syntax

HRESULT get_AddNew(
  ICAPolicy*  pPolicy,
  BSTR  bstrName,
  DATE  dateStart,
  DATE  dateEnd,
  ICAOffer**  ppOffer
);

Parameters

  pPolicy

[in]  Pointer to the ICAPolicy interface of the policy that is creating this offer.

  bstrName

[in]  String containing the short description of the offer.

  dateStart

[in]  Date and time when the offer becomes valid.

  dateEnd

[in]  Date and time when the offer expires.

  ppOffer

[out]  Pointer to a variable that receives the ICAOffer interface of the offer.

Return Values

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

Remarks

If the method succeeds, it triggers an _ICAOffersEvents::ItemAdded event.

After calling this method, the client should do the following:

• Add descriptions in the other formats. See ICAOffer::put_Description.
• Add one or more tolls to the offer. If an offer has no tolls, there is no way for the user to purchase it. See ICAOffer::get_Tolls.

See Also

• ICAOffers Interface