virtual qBool CompleteSuspendedPostObject( ProtocolCallContext * pContext, const qVector< qUnsignedInt64 > & dataIds );
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. |
Value | Description |
---|---|
true |
RMC call initialization succeeded. |
false |
Failure. |
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.
QERROR(DataStore, OperationNotAllowed)
case.CONFIDENTIAL