DWC_LoadOthersDataAsync

C Specification


#include <dwc.h>

BOOL DWC_LoadOthersDataAsync( char* keys, int index, void* param );

				

Description

Loads the data that was saved by someone else with the DWC_SavePublicDataAsync function from the data storage server. Be aware that it is possible to load data even if a friend relationship has not been established (the friend information data type is a friend registry key).

The data for loading is specified in keys and 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 this example. 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 by a friend 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.

Arguments

keys Pointer to the key string for the data to be loaded.
index The user's friend roster index that you want to load.
param Callback parameter

Return Values

TRUE Starting load.
FALSE Cannot load because this DS is offline, the partner is not a friend, or an error is being generated.

See Also

DWC_SavePublicDataAsync, DWC_SavePrivateDataAsync, DWC_LoadOwnDataAsync, DWC_SetStorageServerCallback, DWCLoadFromServerCallback

Revision History

07/24/2006 Added a cautionary note
02/21/2006 Revised errors
12/16/2005 Revisions
07/22/2005 Initial version


CONFIDENTIAL