DWC_SavePrivateDataAsync

C Specification


#include <dwc.h>

BOOL DWC_SavePrivateDataAsync( char* keyvalues, void* param );

				

Description

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.

Arguments

keyvalues Pointer to the database character string (a key/value value).
param Callback parameter

Return Values

TRUE Starting save.
FALSE Cannot save because either the DS is offline or an error is being generated.

See Also

DWC_SavePublicDataAsync, DWC_SetStorageServerCallback, DWCSaveToServerCallback

Revision History

01/31/2006 Added a description about erasing a key
12/16/2005 Revisions
07/22/2005 Initial version