#include <dwc.h>
BOOL DWC_LoadOwnPrivateDataAsync( char* keys, void* param );
This function loads its own data that was saved using the DWC_SavePrivateDataAsync function from the data storage server. The data for loading is specified in keys and must be a NULL-terminated character string.keys 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 non-existent keys or keys saved with the DWC_SavePublicDataAsync function, the callback argument success becomes 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.
Asynchronous processes related to storage may never reach completion if, for example, the line is dropped. For this reason, configure a timeout in the application (approximately 1 minute, if several kilobytes are being stored), or implement some means for the user to cancel the process. To cancel the process, call the DWC_LogoutFromStorageServer function.
keys |
Pointer to the key string for the data to be loaded. |
param |
Callback parameter |
TRUE |
Starting load. |
FALSE |
Cannot load because either the DS is offline or an error is being generated. |
DWC_SavePublicDataAsync
DWC_SavePrivateDataAsync
DWC_LoadOwnPublicDataAsync
DWC_LoadOthersDataAsync
DWC_SetStorageServerCallback
DWCLoadFromServerCallback
2007/12/03 Added a description about timeout/cancel processes.
2006/02/21 Corrections.
2006/01/18 Initial version.
CONFIDENTIAL