GetPersistDataValuesModified

GameSpy SDK

GetPersistDataValuesModified

Retrieves a subset of the data that is stored in key\value delimited pairs, but only if it has been modified since the time provided.

void GetPersistDataValuesModified(
int localid,
int profileid,
persisttype_t type,
int index,
time_t modifiedsince,
gsi_char * keys,
PersDataCallbackFn callback,
void * instance );
RoutineRequired HeaderDistribution
GetPersistDataValuesModified<gpersist.h>SDKZIP

Parameters

localid
[in] Your game-specific reference number for this player
profileid
[in] The profileid of the player whose data you are getting.
type
[in] The type of persistent data you are getting.
index
[in] Each profile can have multiple persistent data records associated with them. Usually 0 is used.
modifiedsince
[in] A time value to limit the request for data.
keys
[in] The key/value pairs to be updated.
callback
[in] Will be called with the data.
instance
[in] Pointer that will be passed to the callback function (for your use.)

Remarks

Modification time is tracked for the given profileid/index, not on a per persisttype basis
Data will only be returned if it has been modified since the time provided. If no data has been modified since that time, the callback will be called with a success value that indicates it is unmodified.

The data will be returned as a null-terminated string, If no data is available, len will be 0 in the callback.

To retrieve the entire data set, use GetPersistData.

Section Reference: Gamespy Persistent Storage SDK