| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The get_TuneRequest method retrieves the TuneRequest object associated with this Service object.
Syntax
HRESULT get_TuneRequest(
IUnknown** ppunk
);
Parameters
ppunk
[out] Address of a variable to receive a pointer to the IUnknown 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_FAIL | The TuneRequest object cannot be found. |
| E_OUTOFMEMORY | There is not enough memory to create the TuneRequest object. |
| E_POINTER | Data cannot be read from or written to a supplied address. |
Remarks
The actual TuneRequest object is stored in the database, because simply storing a pointer to its IUnknown interface would be meaningless. The retrieval mechanism calls OleLoadFromStream to recreate the object and retrieve a pointer to its IUnknown interface.
See Also