> ## 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.

# XGameUiShowSendGameInviteAsync

> XGameUiShowSendGameInviteAsync

# XGameUiShowSendGameInviteAsync

Este método mostra uma interface do usuário de seleção preenchida com a lista de amigos e a lista de amigos sugeridos do jogador selecionado para enviar convites de jogo.

## Sintaxe

```cpp theme={null}
HRESULT XGameUiShowSendGameInviteAsync(  
         XAsyncBlock* async,  
         XUserHandle requestingUser,  
         const char* sessionConfigurationId,  
         const char* sessionTemplateName,  
         const char* sessionId,  
         const char* invitationText,  
         const char* customActivationContext  
)  
```

### Parâmetros

*async*   \_In\_<br />Tipo: [XAsyncBlock\*](/pt-BR/reference/system/xasync/structs/xasyncblock)

Um ponteiro para o [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) que é passado para [XAsyncRun](/pt-BR/reference/system/xasync/functions/xasyncrun).

*requestingUser*   \_In\_<br />Tipo: XUserHandle

Um identificador para o usuário que está enviando os convites.

*sessionConfigurationId*   \_In\_<br />Tipo: char\*

Especifica uma cadeia de caracteres que indica a ID de configuração de serviço do título.

*sessionTemplateName*   \_In\_<br />Tipo: char\*

Especifica uma cadeia de caracteres que indica o nome do modelo de sessão multijogador.

*sessionId*   \_In\_<br />Tipo: char\*

Especifica uma cadeia de caracteres que indica o ID da sessão multijogador para a qual as pessoas serão convidadas.

*invitationText*   \_In\_opt\_<br />Tipo: char\*

Especifica uma cadeia de caracteres que indica o ID da cadeia de caracteres de convite personalizada.<br />Esse ID de cadeia de caracteres é definido na configuração de serviço do XBOX Live para identificar o texto de convite adicional ao texto de convite padrão. A cadeia de caracteres de ID deve ter o prefixo "///". Passe uma cadeia de caracteres vazia se não quiser adicionar uma cadeia de caracteres personalizada ao convite.

*customActivationContext*   \_In\_opt\_<br />Tipo: char\*

O contexto de ativação personalizado que fica disponível para o convidado no URI de ativação de um convite. A cadeia de caracteres do contexto de ativação personalizado deve ser segura para URL, e o conteúdo binário deve ser codificado com a codificação base64 segura para URL. O comprimento máximo é de 160 caracteres.

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT da chamada assíncrona.

## Comentários

Depois que a lista é preenchida, os jogadores podem ser selecionados. O jogador pode enviar um convite para jogar e/ou para um chat de grupo em uma sessão de jogo especificada às pessoas selecionadas na interface do usuário de seleção.

Solicitar uma interface do usuário fará com que seu jogo entre no *modo restrito*. No modo restrito, seu título receberá menos recursos do sistema enquanto estiver em segundo plano em relação à interface do usuário solicitada. Para saber mais sobre o modo restrito e outros modos operacionais do seu título, leia [Ciclo de vida do jogo XBOX (tópico sob NDA)](/pt-BR/build/console-features/console-workflows/xbox-game-life-cycle).

## Requisitos

**Cabeçalho:** XGameUI.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Metas de design e aprimoramentos da programação assíncrona](/pt-BR/build/core-features/common/async/async-whitepaper)
* [Enviar convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## Confira também

[XGameUI](/pt-BR/reference/system/xgameui/xgameui_members)<br />[XGameUiShowSendGameInviteResult](/pt-BR/reference/system/xgameui/functions/xgameuishowsendgameinviteresult)<br />[Ciclo de vida do jogo XBOX (tópico sob NDA)](/pt-BR/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowSendGameInviteAsync](/reference/system/xgameui/functions/xgameuishowsendgameinviteasync.md)
- [XGameUiShowSendGameInviteUiCallback](/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback.md)