#include <dwc.h>
BOOL DWC_SavePrivateDataAsync( char* keyvalues, void* param );
Saves the data that can only be referenced by the player to the data storage server. The data to be saved must be a character string that ends with NULL and is a combination of key/value.
keyvalues
describes data using \\
as a delimiter, as in: \\name\\mario\\stage\\3
. This allows multiple key/value combinations to be saved at once such as in this example.
Once data has been saved, the save completion notification callback specified by DWC_SetStorageServerCallback
is called.
If an empty value such as "\\name\\" is saved for value
, key
can be erased.
However, although it will remain on the data storage server, the erased key
cannot be referenced. Therefore, if a large number of keys are erased this way, it will unnecessarily consume data storage server space.
keyvalues |
Pointer to the database character string (a key/value value). |
param |
Callback parameter |
TRUE |
Starting save. |
FALSE |
Cannot save because either the DS is offline or an error is being generated. |
DWC_SavePublicDataAsync, DWC_SetStorageServerCallback, DWCSaveToServerCallback
01/31/2006 Added a description about erasing a key
12/16/2005 Revisions
07/22/2005 Initial version