ITuningSpaceContainer::Add method (tuner.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
The Add method adds a new persistent tuning space to the system.
Syntax
HRESULT Add(
[in] ITuningSpace *TuningSpace,
[out] VARIANT *NewIndex
);
Parameters
[in] TuningSpace
Pointer to the ITuningSpace interface of the new tuning space
[out] NewIndex
Pointer to a variable of type VARIANT that receives the ID of the new tuning space within the current collection.
Return value
Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.
Remarks
This method adds a new tuning space to the collection. The collection object automatically persists the tuning space information.
The tuning space must have a unique name that does not clash with any of the tuning spaces already in the collection. To overwrite an existing tuning space, use the ITuningSpaceContainer::put_Item method.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | tuner.h |