DWC_LoadOwnPublicDataAsync

Syntax

#include <dwc.h>

BOOL DWC_LoadOwnPublicDataAsync(char *keys,
                                void *param);

Arguments

keys Pointer to the key string for the data to be loaded.
param Callback parameter.

Return Values

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

Description

This function loads this host's own data, that was saved using the DWC_SavePublicDataAsync function, from the data storage server. The data for loading is specified in keys. It must be a NULL-terminated character string. keys is written using "\" as a delimiter, as in "\name\stage". This allows multiple keys to be loaded at once, as in the example just cited. Once data loading is complete, the load completion notification callback specified by DWC_SetStorageServerCallback is called.

When trying to load only non-existent keys or keys saved with the DWC_SavePrivateDataAsync function, the callback argument success becomes FALSE. However, if only some of the specified keys fall into this category, they will not be included in the load data, and the success argument will be TRUE.

The callback might not be called if, during loading, a disconnect occurs in an upper circuit on the router. Use a timeout within the application or an interface that allows the user to cancel.

Call the LogoutFromStorageServer function to cancel.

Revision History

1.4.12
Added information specific to implementation of canceling.

CONFIDENTIAL