Public Member Functions | |
HRESULT | NextOne ([out, retval] IAAFPropertyDef **ppPropertyDefs) |
Enumerates to the next element in the enumerators list. | |
HRESULT | Next ([in] aafUInt32 count,[out, size_is(count), length_is(*pNumFetched)] IAAFPropertyDef **ppPropertyDefs,[out, ref] aafUInt32 *pNumFetched) |
Enumerates the next count elements (AAFPropertyDef 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 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] IEnumAAFPropertyDefs **ppEnum) |
Creates another enumerator with the same state as the current enumerator to iterate over the same list. |
HRESULT IEnumAAFPropertyDefs::Clone | ( | [out, retval] IEnumAAFPropertyDefs ** | ppEnum | ) |
Creates another 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:
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
AAFRESULT_NULL_PARAM
ppEnum | [out,retval] new enumeration |
HRESULT IEnumAAFPropertyDefs::Next | ( | [in] aafUInt32 | count, |
[out, size_is(count), length_is(*pNumFetched)] IAAFPropertyDef ** | ppPropertyDefs, | ||
[out, ref] aafUInt32 * | pNumFetched | ||
) |
Enumerates the next count elements (AAFPropertyDef 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.
Succeeds if all of the following are true:
If this method fails nothing is written to *ppPropertyDefs 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
AAFRESULT_NULL_PARAM
count | [in] number of PropertyDefs requested |
ppPropertyDefs | [out, size_is(count), length_is(*pNumFetched)] array to receive elements |
pNumFetched | [out,ref] number of actual Property Definition objects fetched into ppPropertyDefs array |
HRESULT IEnumAAFPropertyDefs::NextOne | ( | [out, retval] IAAFPropertyDef ** | ppPropertyDefs | ) |
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:
If this method fails nothing is written to *ppPropertyDefs.
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
AAFRESULT_NULL_PARAM
AAFRESULT_NO_MORE_OBJECTS
ppPropertyDefs | [out,retval] The Next Property Definition |
HRESULT IEnumAAFPropertyDefs::Reset | ( | ) |
Instructs the enumerator to position itself at the beginning of the list of elements.
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
HRESULT IEnumAAFPropertyDefs::Skip | ( | [in] aafUInt32 | count | ) |
Instructs the enumerator to skip the next count elements in the enumeration so that the next call to Next will not return those elements.
Succeeds if all of the following are true:
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
AAFRESULT_NO_MORE_OBJECTS
count | [in] Number of elements to skip |