nn::nex::DataStoreLogicServerClient::PerpetuateObject Member Function

Syntax

virtual qBool PerpetuateObject(
     ProtocolCallContext * pContext,
     qUnsignedInt16 persistenceSlotId,
     qUnsignedInt64 dataId,
     qBool deleteLastObject = true
);

Parameters

Name Description
in pContext Call information.
in persistenceSlotId The persistence slot ID for the data that is perpetuated..
in dataId The data ID of the data that is perpetuated.
in deleteLastObject Specifies whether to delete the previous data. The default is to delete the data.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Perpetuates data.

The data is not automatically deleted when it expires. The data registered to the persistence slot ID takes DataStoreConstants::PERMANENT_DATE_TIME as its expiration period. If that same persistence slot ID was previously in use, its data is unperpetuated. deleteLastObject specifies whether to delete that unperpetuated data. The local host can only perpetuate data for which it is the owner. If the persistence slot ID and data ID are the same as was previously set, the process succeeds without any change in state. The same data ID cannot be set to multiple persistent slot IDs. If you try to set the same data ID, the function returns QERROR(DataStore, OperationNotAllowed). If you call the DataStoreClient::DeleteObject function to delete data that has been made persistent, that data is automatically unperpetuated.

Revision History

2012/05/29
Initial version.

CONFIDENTIAL