ITuningSpaceContainer::put_Item method (tuner.h)

Article
12/05/2018

[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 put_Item method saves changes to an existing tuning space in the collection.

Syntax

HRESULT put_Item(
  [in] VARIANT      varIndex,
  [in] ITuningSpace *TuningSpace
);

Parameters

[in] varIndex

VARIANT that specifies the index of the tuning space.

[in] TuningSpace

Pointer to the ITuningSpace interface of the tuning space.

Return value

Returns an HRESULT. Possible values include those in the following table.

Return code	Description
E_INVALIDARG	Invalid argument.
E_POINTER	NULL pointer argument.
S_OK	Success.

�

If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

An application can retrieve an existing tuning space from the collection, modify its properties by calling ITuningSpace methods, and then call put_Item to save the changes. The unique name property on the tuning space must match the tuning space at the specified index in the collection; otherwise, the method returns E_INVALIDARG.

To add a new tuning space, use the ITuningSpaceContainer::Add method.

Requirements

Requirement	Value
Minimum supported client	Windows�XP [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	tuner.h

Share via