在本主题▼

L_ReadFileMetaDataItems

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_ReadFileMetaDataItems(pszFile, pMetaData, pLoadOptions)

获取存储在文件中的所有标记。

参数

L_TCHAR* pszFile

包含输入文件名的字符串。

pL_FILEMETADATAITEMSpMetaData

指向L_FILEMETADATAITEMS结构的指针，该结构将由源映像文件的元数据项填充。当不再需要此数据时，将其传递给L_FreeFileMetaDataItems函数释放已分配的内存。

pLOADFILEOPTIONpLoadOptions

指向可选扩展加载选项的指针。传递NULL以使用默认的加载选项。

价值	意义
成功	活动很成功。
< 1	发生错误。指返回代码．

方法释放使用此函数分配的数据L_FreeFileMetaDataItems函数。

引用的文件pszFile必须是支持XMP的文件格式。例如PNG, PDF, JPEG, TIFF和SVG。

若要确定文件格式是否支持XMP，请使用L_FileMetaDataItemsSupported．

必需的dll和库

LTFIL
LFXMP
有关所需dll和库的确切列表(基于工具包版本)，请参见应用程序中包含的文件．

平台

Win32, x64, Linux。

另请参阅

功能

主题

栅格图像功能:XMP元数据

例子

本例演示了与元数据项相关的所有功能。
它检查文件是否支持元数据，读取元数据项，
打印元数据项数据，然后释放已分配的元数据项。

PrintFileMetaData(L_TCHAR* pFileName)｛L_INT nRet;L_BOOL bIsMetaDataSupported;FILEINFO = {0};//获取文件信息nRet = L_FileInfo(pFileName， &FileInfo，运算符(fileinfo)， 0, null);如果(nRet != SUCCESS)返回nRet;//检查指定文件格式是否支持元数据。bIsMetaDataSupported = L_FileMetaDataItemsSupported(FileInfo.Format);如果(bIsMetaDataSupported)｛L_FILEMETADATAITEMS MetaDataItems = {0};MetaDataItems。uStructSize =运算符(L_FILEMETADATAITEMS);//读取元数据项nRet = L_ReadFileMetaDataItems(pFileName， &MetaDataItems, NULL);如果(nRet != SUCCESS)返回nRet;wprintf(左“项目计数%u\n”, MetaDataItems.uCount);为(L_UINT i = 0;i < metadataitems . uccount;我+ +)｛//打印元数据项中每个项的键和值常量L_FILEMETADATAITEM* item = &MetaDataItems.pItems[i];//key Ex: L_FILEMETADATAKEY_TITLEwprintf(左“% s: % s \ n”， item->键，item->值);｝//释放元数据项L_FreeFileMetaDataItems (&MetaDataItems);｝返回成功;｝