nn::boss::GetOwnNewDataNsDataIdList Function

nn::Result GetOwnNewDataNsDataIdList(
     u32 dataType,
     NsDataIdList * pNsDataId
);

	Name	Description
in	dataType	Specifies the data type. Use DATA_TYPE_ALL to specify all data types. (However, data for Notifications that the application cannot obtain will be excluded.)
out	pNsDataId	Specifies an object storing a list of NS data.

Returns the function's result. Returns one of the Result values listed below.

Value	Description
Result::IsSuccess	Retrieval successful.
ResultNsDataListSizeShortage	Because the size of NsDataIdList was insufficient, not all NS data serial IDs could be stored. Continue and call repeatedly until all NS data serial IDs are obtained.
ResultNsDataListUpdated	The target NS data group for BOSS storage has been updated since the last time a list was obtained.
ResultInvalidNsDataIdList	The pointer to NS data list information is NULL.
ResultStorageNotFound	The BOSS storage corresponding to the appropriate application ID is not registered. Please check if the BOSS storage is registered.
ResultIpcNotSessionInitialized	The session has not been initialized. This Result is returned if this function is called before the Initialize function. Always call the Initialize function before using the BOSS library.
A value other than the above.	Unexpected error (see boss_Result.h for error details).

Excludes the shared NS data, and gets the list of NS content for the application from the expanded save data region where the BOSS storage is registered.
The NS data IDs are stored in descending order from the start of the list.

In other words, only the list of NS data for the invoked application is obtained, even if there is shared NS data.

The new arrival flag is cleared if this function is used to get all lists.
The return value is ER_NSDATA_LIST_SIZE_SHORTAGE if the entire list could not be obtained.
If you call this function more than once and an update in the list's content, such as a new download, is detected, ER_NSDATA_LIST_UPDATED is returned and you must start over. In this case, re-call this function after initializing the instance of NsDataIdList.

　

[How to use the dataType parameter]

See GetNsDataIdList.

2010/09/16

Initial version.