AAFA Developer Support

Public Member Functions
IEnumAAFIdentifications Interface Reference

This interfaces allows access to individual IAAFIdentification-supporting objects within a collection. More...

List of all members.

Public Member Functions

HRESULT NextOne ([out, retval] IAAFIdentification **ppIdentification)
 Enumerates to the next element in the enumerators list.
HRESULT Next ([in] aafUInt32 count,[out, size_is(count), length_is(*pNumFetched)] IAAFIdentification **ppIdentifications,[out] aafUInt32 *pNumFetched)
 Enumerates the next count elements (AAFIdentification pointers) in the enumerator's list, returning them in the given array along with the actual number of enumerated elements in pNumFetched.
HRESULT Skip ([in] aafUInt32 count)
 Instructs the enumerator to skip the next count elements in the enumeration so that the next call to EnumAAFIdentifications::Next will not return those elements.
HRESULT Reset ()
 Instructs the enumerator to position itself at the beginning of the list of elements.
HRESULT Clone ([out, retval] IEnumAAFIdentifications **ppEnum)
 Creates another identification enumerator with the same state as the current enumerator to iterate over the same list.

Detailed Description

This interfaces allows access to individual IAAFIdentification-supporting objects within a collection.

In addition to the specific error results listed for each method, all methods in this interface may also return one of the following values:

AAFRESULT_NOMEMORY

Definition at line 36062 of file AAF.idl.


Member Function Documentation

HRESULT IEnumAAFIdentifications::Clone ( [out, retval] IEnumAAFIdentifications **  ppEnum)

Creates another identification enumerator with the same state as the current enumerator to iterate over the same list.

This method makes it possible to record a point in the enumeration sequence in order to return to that point at a later time.

Note: The caller must release this new enumerator separately from the first enumerator.

Succeeds if all of the following are true:

  • the ppEnum pointer is valid.

This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:

AAFRESULT_SUCCESS

  • succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

  • ppEnum is null.
Parameters:
ppEnum[out, retval] new enumeration
HRESULT IEnumAAFIdentifications::Next ( [in] aafUInt32  count,
[out, size_is(count), length_is(*pNumFetched)] IAAFIdentification **  ppIdentifications,
[out] aafUInt32 *  pNumFetched 
)

Enumerates the next count elements (AAFIdentification pointers) in the enumerator's list, returning them in the given array along with the actual number of enumerated elements in pNumFetched.

The caller is responsible for properly releasing the returned pointers when thery are no longer needed.

Succeeds if all of the following are true:

  • the ppIdentifications pointer is valid.
  • the pNumFetched pointer is valid.
  • there are Identification objects remaining to be returned.

If this method fails nothing is written to *ppIdentifications or pNumFetched.

This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:

AAFRESULT_SUCCESS

  • succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

  • either ppIdentification or pNumFetched is null.
Parameters:
count[in] number of identifications requested
ppIdentifications[out, size_is(count), length_is(*pNumFetched)] array to receive identification objects
pNumFetched[out] number of actual Identifications fetched into ppIdentifications array
HRESULT IEnumAAFIdentifications::NextOne ( [out, retval] IAAFIdentification **  ppIdentification)

Enumerates to the next element in the enumerators list.

The caller is responsible for properly releasing the returned pointer when it is no longer needed.

Succeeds if all of the following are true:

  • the ppIdentification pointer is valid.
  • there are Identification objects remaining to be returned.

If this method fails nothing is written to *ppIdentification.

This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:

AAFRESULT_SUCCESS

  • succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

  • ppIdentification is null.

AAFRESULT_NO_MORE_OBJECTS

  • no Identifications remaining to be returned.
Parameters:
ppIdentification[out, retval] The Next Identification
HRESULT IEnumAAFIdentifications::Reset ( )

Instructs the enumerator to position itself at the beginning of the list of elements.

Always succeeds.

This method will return the following code:

AAFRESULT_SUCCESS

  • succeeded. (This is the only code indicating success.)
HRESULT IEnumAAFIdentifications::Skip ( [in] aafUInt32  count)

Instructs the enumerator to skip the next count elements in the enumeration so that the next call to EnumAAFIdentifications::Next will not return those elements.

Succeeds if all of the following are true:

  • count is less than or equal to the number of remaining objects.

This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:

AAFRESULT_SUCCESS

  • succeeded. (This is the only code indicating success.)

AAFRESULT_NO_MORE_OBJECTS

  • count exceeded number of remaining objects.
Parameters:
count[in] Number of elements to skip

Generated on Wed Jul 4 2012 22:13:32 for AAF COM API by doxygen 1.7.4