chatRetryWithNick
Use in response to a nickErrorCallback. This function allows the local client to retry the connection attempt with a different chat nickname.
- void chatRetryWithNick(
- CHAT chat,
- const gsi_char * nick );
| Routine | Required Header | Distribution |
|---|---|---|
| chatRetryWithNick | <chat.h> | SDKZIP |
Parameters
- chat
- [in] Chat SDK object, previously initialized using one of the chatConnect methods.
- nick
- [in] Alternate chat nickname
Remarks
The chatRetryWithNick function should be used in response to a nickErrorCallback. Most often, this occurs when a requested nickname is already in use. chatRetryWithNick 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 |
|---|---|---|
| chatRetryWithNick | chatRetryWithNickA | chatRetryWithNickW |
chatRetryWithNickW and chatRetryWithNickA are UNICODE and ANSI mapped versions of chatRetryWithNick. The arguments of chatRetryWithNickA are ANSI strings; those of chatRetryWithNickW are wide-character strings.
Section Reference: Gamespy Chat SDK