nn::boss::DataStoreUploadAction

nn::boss::DataStoreUploadAction Class

Syntax

class DataStoreUploadAction :public nn::boss::TaskAction

Description

Class for representing DataStore upload tasks. Use this to do such things as register DataStore upload tasks.

DataStore is one of the NEX library data storage features. It can upload data to and download data from storage, and it also allows users to exchange data. (For more details, see the documentation in the NEX library.))
BOSS DataStore tasks are provided for using these DataStore features via BOSS (SpotPass).
You can use BOSS DataStore tasks for DataStore uploads and downloads even when your application is not running (when the system is in Sleep Mode, for example).

While uploading data, you cannot reuse a task that has already been registered. If a task having the same task ID has already been registered using RegisterTask (ResultTaskIdAlreadyExist), be sure to first unregister the task in question using UnregisterTask and then register it again.

If the system loses power while a task is being registered, the registered task and file information will be invalid. Data cannot be uploaded properly with such a task, so you must use the following procedure to check and handle it.

Immediately after a task has been registered successfully, implement that a start command be performed using the nn::boss::Task::Start, nn::boss::Task::StartImmediate, or nn::boss::Task::StartBgImmediate function. If the system loses power while a task is being registered—preventing it from starting—you can still detect the task because its state as obtained by the nn::boss::Task::GetState function will be TASK_REGISTERED. (The task's state will not be TASK_REGISTERED if the start command succeeded. ) Use the UnregisterTask function to delete tasks like this and then re-register them.

Member Functions

DataStoreUploadAction Constructor.
V ~DataStoreUploadAction Destructor.
Initialize Used to configure DataStore upload.
GetDstCount Returns the number of entries registered as destinations for sending data.
AddDstPrincipalId Adds a destination to send data.
ClearDstPrincipalId Clears all destinations to send data.
V GetProperty Gets a property value from the class.

Class Hierarchy

nn::boss::TaskActionBase
  nn::boss::TaskAction
    nn::boss::DataStoreUploadAction

Revision History

2011/10/27
Initial version.

CONFIDENTIAL