Validates a user's info, without logging into the account.

GPResult gpCheckUser(

GPConnection * connection,

const gsi_char nick[GP_NICK_LEN],

const gsi_char email[GP_EMAIL_LEN],

const gsi_char password[GP_PASSWORD_LEN],

GPEnum blocking,

GPCallback callback,

void * param );

Return Value

This function returns GP_NO_ERROR upon success. Otherwise a valid GPResult is returned.

Parameters

connection

[in] A GP interface object initialized with gpInitialize. (Does not have to be connected.)

nick

[in] The profile nickname.

email

[in] The profile email address.

password

[in] The profile password.

blocking

[in] GP_BLOCKING or GP_NON_BLOCKING

callback

[in] A user supplied callback with an arg type of GPConnectResponseArg.

param

[in] Pointer to user defined data. This value will be passed unmodified to the callback function.

Remarks

This function is rarely used but may be usefull in certain situations. The main advantage is that a user's info may be verified without disrupting other external connections. (gpConnect will usurp any previous connections).

Unicode Mappings

gpCheckUserW and gpCheckUserA are UNICODE and ANSI mapped versions of gpCheckUser. The arguments of gpCheckUserA are ANSI strings; those of gpCheckUserW are wide-character strings.

Section Reference: Gamespy Presence SDK

See Also: GPCheckResponseArg