Sends an authentication request.

void gcd_authenticate_user(

int gameid,

int localid,

unsigned int userip,

char * challenge,

char * response,

AuthCallBackFn authfn,

RefreshAuthCallBackFn refreshfn,

void * instance );

Parameters

gameid

[in] The game ID issued for your game.

localid

[in] A unique int used to identify each client on the server. No two clients should have the same localid.

userip

[in] The client's IP address, preferably in network byte order.

challenge

[in] The challenge string that was sent to the client. Should be no more than 32 characters.

response

[in] The response that the client received.

authfn

[in] A callback that is called when the user is either authorized or rejected.

refreshfn

[in] A callback called when the server needs to re-authorize a client on the local host

instance

[in] Optional free-format user data for use by the callback.

Section Reference: Gamespy CDKey SDK