peerGetPlayerInfoCallback
Called after an attempt to peerGetPlayerInfo is successful.
- typedef void (*peerGetPlayerInfoCallback)(
- PEER peer,
- PEERBool success,
- const gsi_char * nick,
- unsigned int IP,
- int profileID,
- void * param );
| Routine | Required Header | Distribution |
|---|---|---|
| peerGetPlayerInfoCallback | <peer.h> | SDKZIP |
Parameters
- peer
- [in] Initialized peer object
- success
- [in] PEERTrue if successful, PEERFalse if failure
- nick
- [in] The player's nickname that information is being requested for
- IP
- [in] IP address in string form: "xxx.xxx.xxx.xxx"
- profileID
- [in] The player's profile ID
- param
- [in] Pointer to user data. This is optional and will be passed unmodified to the callback function.
Remarks
The peerGetPlayerInfoCallback function will have the information requested by peerGetPlayerInfo. Any succes will be determined by the "success" parameter. If the player did not exist, if the nick is invalid, or peer is not connected, the function will have a failure denoted by "success".
Unicode Mappings
| Routine | GSI_UNICODE Not Defined | GSI_UNICODE Defined |
|---|---|---|
| peerGetPlayerInfoCallback | peerGetPlayerInfoCallbackA | peerGetPlayerInfoCallbackW |
peerGetPlayerInfoCallbackW and peerGetPlayerInfoCallbackA are UNICODE and ANSI mapped versions of peerGetPlayerInfoCallback. The arguments of peerGetPlayerInfoCallbackA are ANSI strings; those of peerGetPlayerInfoCallbackW are wide-character strings.
Section Reference: Gamespy Peer SDK