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

See also

ITuningSpaceContainer Interface