GPGetInfoResponseArg

GameSpy SDK

GPGetInfoResponseArg

The arg parameter passed to a callback generated by a call to gpGetInfo is of this type. The structure provides information about the specified profile.

typedef struct 
{
GPResult result;
GPProfile profile;
gsi_char nick[GP_NICK_LEN];
gsi_char uniquenick[GP_UNIQUENICK_LEN];
gsi_char email[GP_EMAIL_LEN];
gsi_char firstname[GP_FIRSTNAME_LEN];
gsi_char lastname[GP_LASTNAME_LEN];
gsi_char homepage[GP_HOMEPAGE_LEN];
int icquin;
gsi_char zipcode[GP_ZIPCODE_LEN];
gsi_char countrycode[GP_COUNTRYCODE_LEN];
float longitude;
float latitude;
gsi_char place[GP_PLACE_LEN];
int birthday;
int birthmonth;
int birthyear;
GPEnum sex;
GPEnum publicmask;
gsi_char aimname[GP_AIMNAME_LEN];
int pic;
int occupationid;
int industryid;
int incomeid;
int marriedid;
int childcount;
int interests1;
int ownership1;
int conntypeid;
} GPGetInfoResponseArg;

Members

result
The result of the inquiry; GP_NO_ERROR if successful.
profile
The profile for which the info was requested.
nick
The nick for this profile info.
uniquenick
The uniquenick for this profile info.
email
The email for this profile info.
firstname
The firstname for this profile info.
lastname
The lastname for this profile info.
homepage
The homepage for this profile info.
icquin
The ICQ UIN(User Identification Number) for this profile info.
zipcode
The zipcode for this profile info.
countrycode
The countrycode for this profile info.
longitude
Negative is west, positive is east. (0, 0) means unknown.
latitude
Negative is south, positive is north. (0, 0) means unknown.
place
E.g., "USA|California|Irvine", "South Korea|Seoul", "Turkey".
birthday
The day part of this profile’s birthday (1-31).
birthmonth
The month part of this profile’s birthday (1-12).
birthyear
The year part of this profile’s birthday.
sex
An enum indicating the sex for this profile info. The possible values are:
GP_MALE -- The sex for this profile info is male.
GP_FEMALE -- The sex for this profile info is female.
GP_PAT -- The sex for this profile info is unknown.
publicmask
publicmask
A bitwise-or of enums indicating which parts of this profile’s info are public. If the value of publicmask is GP_MASK_NONE then no info is masked. If it is GP_MASK_ALL then all of the mask-able info is masked. If any of the following bits are set, then the corresponding info is masked. If the bit is not set, the info is public:
GP_MASK_HOMEPAGE
    This profile’s homepage info.
GP_MASK_ZIPCODE
    This profile’s zipcode info.
GP_MASK_COUNTRYCODE
    This profile’s countrycode info.
GP_MASK_BIRTHDAY
    This profile’s birthday info.
GP_MASK_SEX
    This profile’s sex info.
If info is masked, then its value in the structure should not be used. For example, if the GP_MASK_BIRTHDAY bit is set, the birthday, birthmonth, and birthyear fields should not be accessed.
aimname
The AOL IM screen name for this profile info.
occupationid
The occupation id for this profile info.
industryid
The industry id for this profile info.
incomeid
The income for this profile info.
marriedid
The marital status for this profile info.
childcount
The child count for this profile info.
interests1
The interests for this profile info.
conntypeid
The connection type for this profile info.

Remarks

If result is not GP_NO_ERROR, then the operation did not complete successfully, and the rest of this structure is invalid and should not be accessed.

Section Reference: Gamespy Presence SDK

See Also: GPCallback, gpGetInfo