DWC_LoadOthersDataAsync

Syntax

#include <dwc.h>
BOOL DWC_LoadOthersDataAsync(char *keys,
                             int index,
                             void *param);

Arguments

keys Pointer to the key string for the data to be loaded.
index User's friend roster index that you want to load.
param Callback parameter.

Return Values

TRUE Starting load.
FALSE Cannot load because this Nintendo DS is offline, the partner is not a friend, or an error is being generated.

Description

Loads data from the data storage server that was saved by another player using the DWC_SavePublicDataAsync function. Be aware that it is possible to load data even if a friend relationship has not been established with the player in question (that is, if their friend information data type is a friend registry key).

The data for loading is specified in keys and must be a null-terminated string.
The keys string is written using "\" as a delimiter, as in "\name\stage". This allows multiple keys to be loaded at once, as in this example. Once data loading is complete, the load completion notification callback specified by DWC_SetStorageServerCallback is called.

When trying to load only nonexistent keys or keys saved with the DWC_SavePrivateDataAsync function, the callback argument success returns FALSE. However, if only some of the specified keys fall into this category, they will not be included in the load data, and the success argument will be TRUE.

The callback might not be called in situations such as when a disconnection occurs somewhere upstream from the router during loading. Accordingly, on the application side, you must implement timeouts or an interface that allows the user to cancel.

Call the DWC_LogoutFromStorageServer function to cancel.

In the event that data save and load operations occur simultaneously, data will not be loaded while it is currently being saved. The data is loaded either before or after it is saved.

Revision History

5.1 PR2
Replaced DWC_LoadOwnDataAsync with DWC_LoadOwnPrivateDataAsync in line with the deprecation of the DWC_LoadOwnDataAsync function.

For the changelog prior to 5.1 PR2, click here.


CONFIDENTIAL