nn::nex::DataStorePostObjectEventListener::PostChunkedBuffer Member Function

Syntax

virtual qUnsignedInt32 PostChunkedBuffer(
     void * buffer,
     qUnsignedInt32 bufferSize,
     qBool * completed
) = 0;

Parameters

Name Description
out buffer Data to be uploaded is written here.
in bufferSize The maximum size that can be written into buffer. Pass a value between 1 and the value set by the DataStoreClient::SetRelayBufferSize function.
out completed Assigned a value of true if upload succeeded; otherwise, assigned a value of false or not set. If set to true, this function cannot be called later.

Return Values

Returns the size written into buffer. Make sure this value is equal to or greater than 0 and less than or equal to bufferSize. The upload process can be temporarily halted by repeatedly returning 0.

Description

Splits up and registers data to be uploaded.

When data upload starts, this function is called multiple times until asynchronous processing completes. Data to be uploaded is sequentially written into buffer. If completed has been set to true, the total size written must exactly match the size specified at time of upload. If they do not match, processing is the same as when execution is canceled. Also, execution is similarly canceled even if completed is not set to true, when the size written is larger than the size specified at time of upload. You can use the DataStoreClient::SetRelayBufferSize function to set a maximum size for the passed buffer.

Revision History

2012/01/27
Added that you can use the DataStoreClient::SetRelayBufferSize function to set a maximum size for the passed buffer.
2011/01/27
Initial version.

CONFIDENTIAL