Platform SDK: TAPI

ITMediaCollection::get_Item

Gets ITMedia pointer corresponding to the specified index.

HRESULT get_Item(
  LONG Index,
  ITMedia **pVal
);

Parameters

Index
[in] Index of media item to get.
pVal
[out] Pointer to ITMedia interface for desired item.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The pVal parameter is not a valid pointer.
E_INVALIDARG The Index parameter is not valid.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_FAIL Unspecified error.
E_NOTIMPL This method is not yet implemented.

Remarks

Most C and C++ lists are 0-based, but this index is 1-based for Visual Basic compatibility, meaning the first item has an index number of 1.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Sdpblb.h.
  Library: Use Sdpblbid.lib.

See Also

ITMediaCollection