nn::nex::DataStoreSearchParam::SetDestinationIds Member Function

Syntax

void SetDestinationIds(
     const qVector< qUnsignedInt32 > & destinationIds
);

Parameters

Name Description
in destinationIds The list of principal IDs, specified as access privileges, to search for. When you specify several principal IDs, search is performed using OR.

Return Values

None.

Description

Sets the principal IDs of the access rights owners to search for.

When setting access privileges during data upload, the rights holder's principal ID can be set in the second argument of the DataStorePermission::DataStorePermission function. If this function is used, you can search for data by specifying the rights holder's principal ID. If not specified, this condition is removed from search conditions. You can specify this if the search type is either DataStoreConstants::SEARCH_TYPE_PUBLIC or DataStoreConstants::SEARCH_TYPE_FRIEND. To include the local host's own access privileges in the search, set the search type to DataStoreConstants::SEARCH_TYPE_RECEIVED. When DataStoreConstants::SEARCH_TYPE_RECEIVED is used, you do not need to set the local host's own principal ID with this function. (But an error will not occur if the local host's principal ID is specified.) It can be used to choose the access privilege holder as the send destination, and search for data that a specific person has received.

Revision History

2012/11/15
Changed the expression "recipient" to the access privilege holder. Added the description about usage.
2011/04/25
Added mention that this can be specified when the search type is either DataStoreConstants::SEARCH_TYPE_PUBLIC or DataStoreConstants::SEARCH_TYPE_FRIEND. Added mention that you do not need to specify the local system's principal ID using this function when the search type is DataStoreConstants::SEARCH_TYPE_RECEIVED because data sent to the local system can be obtained automatically.
2011/01/27
Initial version.

CONFIDENTIAL