Used to reauthenicate a client for the purpose of proving a client is still online.

typedef void (*RefreshAuthCallBackFn)(

int gameid,

int localid,

int hint,

char * challenge,

void * instance );

Parameters

gameid

[in] the game ID used to initialize the SDK with

localid

[in] the index of the player

hint

[in] a session id for a client used for reauthentication - this is the skey passed into gcd_process_reauth

challenge

[in] a challenge string used for reautentication

instance

[in] user data passed in gcd_authenticate_user

Remarks

The reauthentication callback will be called any time the validation server wishes to determine if a client is still online. When called, the client index, challenge, and session key will be available. These values must be used to reauthenticate the user. Remember that this process is similar to the primary authentication process, where the only difference is that the validation server provides the challenge and session key (note: the "hint" parameter in this callback is the session key that should be passed as the "skey" value into gcd_process_reauth).

Section Reference: Gamespy CDKey SDK