nn::nex::DataStoreClient::GetObject Member Function

Syntax

virtual qBool GetObject(
     ProtocolCallContext * pContext,
     const DataStoreGetParam & param,
     void * buffer,
     qUnsignedInt32 bufferSize,
     qUnsignedInt32 * pWrittenSize
);

Parameters

Name Description
in pContext Call information.
in param Detailed information.
out buffer Buffer where downloaded data is written.
in bufferSize The buffer size. Specify a value equal to or greater than the size of data to be downloaded.
out pWrittenSize Pointer that stores the size of the downloaded data. The size is not stored if a null value is specified.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Gets data from 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. Downloaded data is written to buffer. Data can only be retrieved from buffer when asynchronous processing was successful. When this function is called on data uploaded using DataStoreClient::PostObject, which only updates metadata, it returns QERROR(DataStore, OperationNotAllowed). Use the DataStoreClient::GetMeta function instead. Only those people with access rights to the data can reference it. This member function will no longer be updated because the reference date and count will be removed.

Revision History

2013/08/01
Noted that this member function will no longer be updated because the reference date and count will be removed.
2012/08/06
Added a note about theQERROR(DataStore, OperationNotAllowed) case.
2012/07/12
Added pWrittenSize to Parameters.
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 only people with access rights to the data can reference it.
2011/01/27
Initial version.

CONFIDENTIAL