IComponents::put_Item 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 put_Item method inserts a component into the collection, replacing the item that is identified by the specified index.

Syntax

HRESULT put_Item(
  [in] VARIANT    Index,
  [in] IComponent *ppComponent
);

Parameters

[in] Index

Specifies the index to assign to the component. This parameter is a value of type VARIANT.

[in] ppComponent

Pointer to the IComponent interface of the component object. The method creates a clone of the component and inserts the clone into the 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 allows the client to replace an existing item in the collection.

If the collection contains n items, valid indexes are in the range 0 to n-1. To determine the number of items in the collection, call get_Count.

Requirements

See also

IComponents Interface

get_Item