peerRetryWithNick
Use in response to a nickErrorCallback. This function allows the local client to retry the connection attempt with a different chat nickname.
- void peerRetryWithNick(
- PEER peer,
- const gsi_char * nick );
| Routine | Required Header | Distribution |
|---|---|---|
| peerRetryWithNick | <peer.h> | SDKZIP |
Parameters
- peer
- [in] Initialized peer object.
- nick
- [in] Set to zero unless directed otherwise by GameSpy.
Remarks
The peerRetryWithNick function should be used in response to a nickErrorCallback. Most often, this occurs when a requested nickname is already in use. peerRetryWithNick should be called with an alternate nickname such as "oldnick{1}" to continue the login process. If another nickError occurs, the nickErrorCallback will be triggered again.
Unicode Mappings
| Routine | GSI_UNICODE Not Defined | GSI_UNICODE Defined |
|---|---|---|
| peerRetryWithNick | peerRetryWithNickA | peerRetryWithNickW |
peerRetryWithNickW and peerRetryWithNickA are UNICODE and ANSI mapped versions of peerRetryWithNick. The arguments of peerRetryWithNickA are ANSI strings; those of peerRetryWithNickW are wide-character strings.
Section Reference: Gamespy Peer SDK