RegisterStorage

nn::boss::RegisterStorage Function

Syntax

nn::Result RegisterStorage(
     bit32 storageId,
     size_t storageSize,
     nn::boss::StorageType storageType = nn::boss::USER_EXT_SAVEDATA_STORAGE
);

nn::Result RegisterStorage(
     bit32 storageId,
     size_t storageSize,
     u16 entryCount,
     nn::boss::StorageType storageType = nn::boss::USER_EXT_SAVEDATA_STORAGE
);

List of Overloaded Member Functions

RegisterStorage ( bit32, size_t, nn::boss::StorageType ) Registers BOSS storage.
RegisterStorage ( bit32, size_t, u16, nn::boss::StorageType ) Registers BOSS storage.

Description of RegisterStorage ( bit32, size_t, nn::boss::StorageType )

BOSS storage must be registered before registering or executing NADL tasks.
NS data cannot be downloaded if the storage is not registered.

Before registering BOSS storage, you must first create an extended save data region in memory.
You must also create an expanded save data region, while specifying more than the total number of NS data files to be stored.
This function returns an error if you specify an expanded save data region ID in the storageID argument to which the application does not have access rights.

When downloading NS data, if the total size of NS data for BOSS storage exceeds the maximum data size, the NS data having the oldest serial ID (=the lowest serial ID) is automatically deleted.

1) To get NS data without the application registering a task
If an application has already registered BOSS storage, and NS data addressed to that application is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.

2) To download NS data addressed to the application that registers a task
If the application registers BOSS storage and then registers and runs a task, it can download NS data addressed to the application and store it in the BOSS storage specified when it registered the task. In addition, the same as with 1) above, if NS data addressed to the application that registered BOSS storage is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.

3) To share NS data with another application
You can get NS data downloaded to another application by registering BOSS storage ahead of time in the same extended save data region as that for another application. An application can even get this NS data from other applications when it downloads its own NS data. For more information on these operations, see the GetNsDataIdList and GetNewDataNsDataIdList functions.

Description of RegisterStorage ( bit32, size_t, u16, nn::boss::StorageType )

BOSS storage must be registered before registering or executing NADL tasks.
NS data cannot be downloaded if the storage is not registered.

Before registering BOSS storage, you must first create an extended save data region in memory.
You must also create an expanded save data region, while specifying more than the total number of NS data files to be stored.
This function returns an error if you specify an expanded save data region ID in the storageID argument to which the application does not have access rights.

When downloading NS data, if the total size of NS data for BOSS storage exceeds the maximum data size, the NS data having the oldest serial ID (=the lowest serial ID) is automatically deleted. Similarly, even if the amount of NS data in BOSS storage exceeds entryCount, the NS data having the oldest serial ID (=the lowest serial ID) is automatically deleted.

1) To get NS data without the application registering a task
If an application has already registered BOSS storage, and NS data addressed to that application is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.

2) To download NS data addressed to the application that registers a task
If the application registers BOSS storage and then registers and runs a task, it can download NS data addressed to the application and store it in the BOSS storage specified when it registered the task. In addition, the same as with 1) above, if NS data addressed to the application that registered BOSS storage is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.

3) To share NS data with another application
You can get NS data downloaded to another application by registering BOSS storage ahead of time in the same extended save data region as that for another application. An application can even get this NS data from other applications when it downloads its own NS data. For more information on these operations, see the GetNsDataIdList and GetNewDataNsDataIdList functions.


CONFIDENTIAL