Microsoft DirectX 8.1 (C++)

IGuideDataProviders::get_AddNew

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

The get_AddNew method retrieves a GuideDataProvider object from the collection. If no object with the specified name exists, one is added.

Syntax

HRESULT get_AddNew(
  BSTR  bstrName,
  IGuideDataProvider**  ppdataprovider
);

Parameters

bstrName

[in]  Specifies the name of the object.

ppdataprovider

[out]  Address of a variable to receive a pointer to the IGuideDataProvider interface of the retrieved 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 is 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 retrieved by using IGuideStore::get_GuideDataProviders.

See Also