nn::nex::DataStoreClient::CompleteSuspendedPostObject Member Function

Syntax

virtual qBool CompleteSuspendedPostObject(
     ProtocolCallContext * pContext,
     const qVector< qUnsignedInt64 > & dataIds
);

Parameters

Name Description
in pContext Call information.
in dataIds List of data IDs for which to complete upload. Only data IDs for data uploaded with DataStoreConstants::DATA_FLAG_NEED_COMPLETION specified can be specified.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Tells the server that upload processes were completed for all uploads that suspended completion, and enables the corresponding data.

This function can only be used for data uploaded with DataStoreConstants::DATA_FLAG_NEED_COMPLETION specified in the DataStoreClient::PostObject function. For more information, see the Programming Manual. The data that corresponds to the data IDs that are specified as arguments has atomic processing enabled. After this function is called, the specified data is either all valid or all invalid. If the process fails for even one data set, the process is rolled back at that time. If an error occurs, you can get the first error with the CallContextGetOutcome function. You can use this function, for example, when you want to upload multiple related data sets. Data uploaded with DataStoreConstants::DATA_FLAG_NEED_COMPLETION specified cannot be accessed or modified by anybody until this function makes that data valid. If persistence settings were configured for the data, they take effect when this asynchronous process is successful. Uploaded data must be enabled with this function within three hours from when the DataStoreClient::PostObject function was started. After three hours, the data on the server is automatically deleted. If DataStoreConstants::DATA_FLAG_NEED_COMPLETION was not specified, this function does not need to be called because the data on the server becomes valid at the same time that the DataStoreClient::PostObject function completes. This function returns QERROR(DataStore, OperationNotAllowed) if called on data that has already been enabled.

Revision History

2012/08/06
Added a note about the QERROR(DataStore, OperationNotAllowed) case.
2012/07/31
Initial version.

CONFIDENTIAL