nn::nex::DataStoreClient::UpdateObject Member Function

Syntax

virtual qBool UpdateObject(
     ProtocolCallContext * pContext,
     const DataStoreUpdateParam & param,
     const void * buffer,
     qBool useInternalBuffer = true
);

Parameters

Name Description
in pContext Call information.
in param Detailed information.
in buffer The data to upload. The size of the data specified by the DataStoreUpdateParam::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 DataStoreUpdateParamSetSize 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

Replaces data uploaded 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 ID does not change. When this function is called on data uploaded using DataStoreClient::PostObject, which only updates metadata, it returns QERROR(DataStore, OperationNotAllowed). Use DataStoreClient::ChangeMeta to make changes to metadata. Only data that has update permission can be updated.

Revision History

2013/03/27
Explained that memory is allocated when true is specified for the useInternalBuffer argument.
2012/10/23
Changed the "Only data uploaded by the local host can be updated" explanation to "Only data that has update permission can be updated."
2012/08/06
Added a note about the QERROR(DataStore, OperationNotAllowed) case.
2011/06/23
Noted that if you call this function, a thread for communication is created regardless of the NEX thread mode.
2011/01/27
Initial version.

CONFIDENTIAL