This function extracts metadata from mail stores, mail messages, and non-mail items. See Extract Mail Metadata.
int (pascal *fpGetSubFileMetaData) ( void *pFile, KVGetSubFileMetaArg metaArg, KVSubFileMetaData *metaData);
pFile
|
The identifier of the file. This is a file handle returned from fpOpenFile(). |
metaArg
|
A pointer to the KVGetSubFileMetaArg structure, which defines metadata tags whose values are retrieved. Before you initialize the |
metaData
|
A pointer to the KVSubFileMetaData structure, which contains the retrieved metadata values. |
KVERR_Success
. 0
for metaArg->metaNameCount
, and NULL
for metaArg->metaNameArray
. To extract all metadata, pass in -1
for metaArg->metaNameCount
and NULL
for metaArg->metaNameArray
. For more information, see Extract Mail Metadata.#####
) as a delimiter.KVSubFileMetaData metaData = NULL; KVStructInit(&metaArg); /* retrieve all the default metadata elements */ metaArg.metaNameCount = 0; metaArg.metaNameArray = NULL; metaArg.index = Index; error = extractInterface->fpGetSubFileMetaData(pFile,&metaArg,&metaData); ... extractInterface->fpFreeStruct(pFile,metaData); metaData = NULL; /* retrieve specific metadata fields */ KVMetaName pName[2]; KVMetaNameRec names[2]; names[0].type = KVMetaNameType_Integer; names[0].name.iname = KVPR_SUBJECT; names[1].type = KVMetaNameType_Integer; names[1].name.iname = KVPR_DISPLAY_TO; pName[0] = &names[0]; pName[1] = &names[1]; metaArg.metaNameCount = 2; metaArg.metaNameArray = pName; metaArg.index = Index; error = extractInterface->fpGetSubFileMetaData (pFile,&metaArg,&metaData); ... extractInterface->fpFreeStruct(pFile,metaData); metaData = NULL;
|