IITEncoderCollection Interface Reference

List of all members.

---

Detailed Description

Represents a collection of encoder objects.

The IiTunes::Encoders property returns the collection of encoders.

Public Member Functions
Properties
HRESULT	Count ([out, retval] long *count)
	Returns the number of encoders in the collection.
HRESULT	Item ([in] long index,[out, retval] IITEncoder **iEncoder)
	Returns an IITEncoder object corresponding to the given index (1-based).
HRESULT	ItemByName ([in] BSTR name,[out, retval] IITEncoder **iEncoder)
	Returns an IITEncoder object with the specified name.
HRESULT	_NewEnum ([out, retval] IUnknown **iEnumerator)
	Returns an IEnumVARIANT object which can enumerate the collection.

---

Member Function Documentation

HRESULT IITEncoderCollection::_NewEnum (  [out, retval] IUnknown **  iEnumerator  )

Returns an IEnumVARIANT object which can enumerate the collection. Note: This property is available in iTunes 4.7 and later (iTunes type library 1.2 and later). Parameters: iEnumerator  Returns an IEnumVARIANT object which can enumerate the collection. Return values: S_OK  The operation was successful. E_POINTER  iEnumerator is NULL. E_FAIL  An unexpected error occurred.

HRESULT IITEncoderCollection::Count (  [out, retval] long *  count  )

Returns the number of encoders in the collection. Parameters: count  Returns the number of encoders in the collection. Return values: S_OK  The operation was successful. E_POINTER  count is NULL. E_FAIL  An unexpected error occurred.

HRESULT IITEncoderCollection::Item (  [in] long  index, [out, retval] IITEncoder **  iEncoder )

Returns an IITEncoder object corresponding to the given index (1-based). Parameters: index  1-based index of IITEncoder to retrieve. iEncoder  Returns an IITEncoder object corresponding to the specified index. Return values: S_OK  The operation was successful. S_FALSE  index is too big. E_INVALIDARG  index is less than one. E_POINTER  iEncoder is NULL. E_FAIL  An unexpected error occurred.

HRESULT IITEncoderCollection::ItemByName (  [in] BSTR  name, [out, retval] IITEncoder **  iEncoder )

Returns an IITEncoder object with the specified name. Parameters: name  1-based index of IITEncoder to retrieve. iEncoder  Returns an IITEncoder object with the specified name. Return values: S_OK  The operation was successful. S_FALSE  An encoder with the specified name could not be found. E_POINTER  name or iEncoder is NULL. E_FAIL  An unexpected error occurred.

---