fpGetNext()
Gets the next metadata element from a KVMetadataList. Call this function to iterate through the elements, beginning with the first. File Content Extraction does not guarantee to iterate through metadata elements in any particular order.
Syntax
KVErrorCode(pascal* fpGetNext)( const struct tag_KVMetadataList* const pMetadata, const KVMetadataElement** const ppMetadataElement);
Arguments
pMetadata
|
A pointer to a KVMetadataList that you obtained by calling fpGetSubFileMetadataList(). This must be the same KVMetadataList pointer that you are calling fpGetNext() on. |
ppMetadataElement
|
A pointer to a const KVMetadataElement pointer. On success, this will point to a KVMetadataElement containing the next metadata element in the list, or be set to NULL if the end of the list has been reached. |
Returns
The return value is an error code.
Lifetime and Memory Management
The KVMetadataElement
that was returned in ppMetadataElement
does not need to be freed, but is only valid while the KVMetadataList
has not been freed. After you free the KVMetadataList
, all elements associated with it are invalid, and you must not access any of their members.
Discussion
After iterating through all of the elements in the list, ppMetadataElement
will point to a pointer whose value is NULL.