| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The putref_ActiveGuideDataProvider method adds a GuideDataProvider object reference to the Guide Store that identifies the source of new information to be stored in the Guide Store.
Syntax
HRESULT putref_ActiveGuideDataProvider(
IGuideDataProvider* pnewVal
);
Parameters
pnewVal
[out] Specifies the IGuideDataProvider interface of the information source.
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_POINTER | Data cannot be read from or written to a supplied address. |
Remarks
The current Guide Store provider identifies the source of information being stored in the repository. All stored information is tagged with the current Guide Store provider. If you want to store your own information, you should change the current Guide Store provider to identify your application as the source of information by using IGuideStore::putref_ActiveGuideStoreProvider. Unless this is done, you might find it difficult to retrieve just your information from the Guide Store.
See Also