nn::nex::DataStoreClient::PostObject Member Function

Syntax

virtual qBool PostObject(
     ProtocolCallContext * pContext,
     const DataStorePostParam & param,
     qUnsignedInt64 * dataId,
     const void * buffer,
     qBool useInternalBuffer = true
);

Parameters

Name Description
in pContext Call information.
in param Detailed information.
out dataId Data ID assigned to uploaded data. The data ID is a unique value within the game.
in buffer The data to upload. The size of the data specified by the DataStorePreparePostParam::SetSize function is uploaded for param.
in useInternalBuffer If true (default) is specified, it is okay if the data in buffer is destroyed by the caller because it is copied and maintained inside the library. In this instance, the library allocates a memory region of the size specified by the DataStorePostParamSetSize function. If false is specified, data in the buffer should be maintained until asynchronous processing is complete.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Uploads data to the DataStore server.

You must initialize the HTTP library by calling the nn::http::Initialize function before this function is called. If you call this function, a thread for communication is created, regardless of the NEX thread mode. The data to upload is specified by buffer. The data that are uploaded using this function are stored in a special storage server, separate from the metadata.

Revision History

2013/03/27
Explained that memory is allocated when true is specified for the useInternalBuffer argument.
2011/06/23
Noted that if you call this function, a thread for communication is created regardless of the NEX thread mode.
2011/04/25
Added a statement that it can update only the data uploaded by the local system.
2011/03/03
Added a description that the data ID is unique within the game.
2011/01/27
Initial version.

CONFIDENTIAL