Quick Reference > Data Types > XMP Metadata > L_FILEMETADATAITEMS

L_FILEMETADATAITEMS

typedef struct _L_FILEMETADATAITEMS 
{ 
   L_UINT uStructSize; 
   L_UINT uFlags; 
   L_UINT uCount; 
   L_FILEMETADATAITEM* pItems; 
} L_FILEMETADATAITEMS, *pL_FILEMETADATAITEMS;

The L_FILEMETADATAITEMS structure contains metadata items in a list of key-value pairs.

Member	Description
uStructSize	Size of this structure, in bytes. Use the sizeof operator to calculate this value.
uFlags	Reserved for future use, pass 0.
uCount	Number of items in pItems.
pItems	The number of bytes in the data items.

Comments

pL_FILEMETADATAITEMS is a pointer to a L_FILEMETADATAITEMS structure. Where the function parameter type is pL_FILEMETADATAITEMS, you can declare a L_FILEMETADATAITEMS variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pL_FILEMETADATAITEMS variable is necessary only if your program requires a pointer.

Pass an address to pL_FILEMETADATAITEMS to L_ReadFileMetaDataItems to read the metadata items stored in an image file. This function will allocate this pointer with an array of pL_FILEMETADATAITEMS structures, one for each item found. When you are done using the pL_FILEMETADATAITEMS pointer, you must pass it to the L_FreeFileMetaDataItems to free the allocated memory.