IComponents::put_Item Method

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 *pComponent
);

Parameters

  • Index [in]
    Specifies the index to assign to the component. This parameter is a value of type VARIANT.

  • pComponent [in]
    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

Header Declared in Dshow.h.
DLL Requires Quartz.dll.

See Also

get_Item
IComponents Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008