DWC_SavePublicDataAsync

Syntax


#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 the NULL terminator and is a combination of key/value pairs.

keyvalues describes data using \\ as a delimiter, as in: \\name\\mario\\stage\\3. This allows multiple key/value pairs to be saved at once, such as in the example just cited.

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 the erased key cannot be referenced, it remains on the data storage server. Therefore, if a large number of keys are erased this way, it will unnecessarily consume data storage server space.

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.

Arguments

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

Return Values

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

See Also

DWC_SavePrivateDataAsync
DWC_SetStorageServerCallback
DWCSaveToServerCallback

Revision History

2007/12/03 Added a description about timeout/cancel processes.
2006/01/31 Added a description about deleting key.
2005/12/16 Revisions.
2005/07/22 Initial version.


CONFIDENTIAL