DWC_SavePublicDataAsync

C Specification


#include <dwc.h>

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

				

Description

Saves data that can be referenced by anyone 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_SavePrivateDataAsync, DWC_SetStorageServerCallback, DWCSaveToServerCallback

Revision History

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


CONFIDENTIAL