DWC_SavePrivateDataAsync

Syntax

#include <dwc.h>

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

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 this host is offline or an error is being generated.

Description

Saves the data that can be referenced only by the player onto 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 denotes a string 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 an 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.

Revision History


CONFIDENTIAL