nn::nex::DataStoreClient::GetMeta Member Function

Syntax

virtual qBool GetMeta(
     ProtocolCallContext * pContext,
     const qVector< qUnsignedInt64 > & dataIds,
     const DataStoreGetMetaParam & param,
     qVector< DataStoreMetaInfo > * pMetaInfos,
     qVector< qResult > * pResults = NULL
);

Parameters

Name Description
in pContext Call information.
in dataIds The dataId of the data to get the metadata for.
in param Detailed information.
out pMetaInfos Obtained result.
out pResults Whether the call was successful. (Can be omitted.)

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Batch-gets metadata from storage.

If you want to use this function to get tags, ratings information, binary data in the metadata, or principal IDs that have permissions, use the DataStoreGetMetaParam::SetResultOption function to set the information you want to get. The default setting is not to get this information. The function gets the metadata for the data specified with dataIds using the conditions specified in param. However, information specified with the DataStoreGetMetaParamSetDataId or DataStoreGetMetaParam::SetPersistenceTarget function is ignored. Up to 100 sets of metadata can be batch-processed. The result of processing each data ID specified in dataIds is returned to pMetaInfos and pResult in the same order in which they were specified. Results are returned for only the specified number of data sets. Only people who have access rights to the data can get the data. When the specified data is not found or the user does not have access rights, the object contained in pMetaInfos becomes invalid. You can check whether an object is valid or invalid with the DataStoreMetaInfo::IsValid function.

Revision History

2011/07/04
Added that information specified with the DataStoreGetMetaParamSetDataId or DataStoreGetMetaParam::SetPersistenceTarget function is ignored.
2011/04/25
Added statement that only people who have access rights to the data can get it.
2011/01/27
Initial version.

CONFIDENTIAL