Microsoft DirectX 8.1 (C++)

IServices::get_AddNew

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

The get_AddNew method adds a Service object to the collection.

Syntax

HRESULT get_AddNew(
  IUnknown*  punkTuneRequest,
  BSTR  bstrProviderName,
  BSTR  bstrProviderDescription,
  BSTR  bstrProviderNetworkName,
  DATE  dtStart,
  DATE  dtEnd,
  IService**  ppVal
);

Parameters

punkTuneRequest

[in]  Specifies the IUnknown interface of a TuneRequest object.

bstrProviderName

[in]  Specifies the service provider name.

bstrProviderDescription

[in]  Specifies the service provider description.

bstrProviderNetworkName

[in]  Specifies the service provider network name.

dtStart

[in]  Specifies the start time of the service.

dtEnd

[in]  Specifies the end time of the service.

ppVal

[out]  Address of a variable to receive a pointer to the IService interface of the object.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_OUTOFMEMORY There was not sufficient memory to create a new object.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

This method is valid only for collections returned by using IGuideStore::get_Services.

All of the input arguments are added as attributes of the newly created Service object.

See Also