> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameInviteEventCallback (preterido)

> XGameInviteEventCallback (preterido)

# XGameInviteEventCallback (preterido)

<Info>Esta API agora está preterida. Use [XGameActivationCallback](/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback) em vez disso.</Info>

Um retorno de chamada que um aplicativo define para um evento de convite de jogo.

## Sintaxe

```cpp theme={null}
void XGameInviteEventCallback(  
         void* context,  
         const char* inviteUri  
)  
```

### Parâmetros

*context*   \_In\_opt\_\
Tipo: void\*

O contexto que passamos para [XGameInviteRegisterForEvent](/pt-BR/reference/system/xgameinvite/functions/xgameinviteregisterforevent).

*inviteUri*   \_In\_\
Tipo: char\*

O URI para ingressar na sessão de jogo.\
<Note>O XSAPI sabe como consumir o URI.</Note>

### Valor retornado

Tipo: void

<a id="ID_XGameInviteEventCallback_Remarks" />

## Comentários

Para registrar um retorno de chamada para um evento de convite de jogo, chame [XGameInviteRegisterForEvent](/pt-BR/reference/system/xgameinvite/functions/xgameinviteregisterforevent). A função usa um ponteiro para um **XGameInviteEventCallback** como argumento.

Para cancelar o registro de um retorno de chamada para um evento de convite de jogo, chame [XGameInviteUnregisterForEvent](/pt-BR/reference/system/xgameinvite/functions/xgameinviteunregisterforevent).

O exemplo de código a seguir registra um retorno de chamada de convite de jogo.

```cpp theme={null}
#include <XTaskQueue.h>
#include <XGameInvite.h>  
  
XTaskQueueHandle g_taskQueue;  
XTaskQueueRegistrationToken g_gameInviteEventToken;  
  
void OnGameInvite(void* context, const char* inviteUri)  
{  
    if (inviteUri != nullptr)
    {
        std::string inviteString(inviteUri);
        auto pos = inviteString.find("handle=");
        auto inviteHandeId = inviteString.substr(pos + 7, 36);
        // Now call XblMultiplayerManagerJoinLobby if using MPM
        // or call XblMultiplayerWriteSessionByHandleAsync if using MPSD APIs
    }
}  
  
void InitializeGame()  
{  
    XGameInviteRegisterForEvent(g_taskQueue, nullptr, OnGameInvite, &g_gameInviteEventToken);  
}  
  
void ShutdownGame()  
{  
    XGameInviteUnregisterForEvent(g_gameInviteEventToken);  
}  
```

## Requisitos

**Cabeçalho:** XGameInvite.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XGameInvite](/pt-BR/reference/system/xgameinvite/xgameinvite_members)

[XGameInviteRegisterForEvent](/pt-BR/reference/system/xgameinvite/functions/xgameinviteregisterforevent)

[XGameInviteUnregisterForEvent](/pt-BR/reference/system/xgameinvite/functions/xgameinviteunregisterforevent)


## Related topics

- [XGameInviteEventCallback (deprecated)](/zh-CN/reference/system/xgameinvite/functions/xgameinviteeventcallback.md)
- [XGameInviteEventCallback (en desuso)](/es/reference/system/xgameinvite/functions/xgameinviteeventcallback.md)
- [XGameInviteUnregisterForEvent (deprecated)](/reference/system/xgameinvite/functions/xgameinviteunregisterforevent.md)
- [XGameInviteRegisterForEvent (deprecated)](/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)
- [XGameInvite (deprecated)](/reference/system/xgameinvite/xgameinvite_members.md)