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

Cette méthode affiche une interface utilisateur de sélection remplie à partir de la liste d'amis et de la liste d'amis suggérés du joueur sélectionné, afin d'envoyer des invitations de jeu.

## Syntaxe

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

### Paramètres

*async*   \_In\_<br />Type : [XAsyncBlock\*](/fr/reference/system/xasync/structs/xasyncblock)

Pointeur vers le [XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock) qui est passé à [XAsyncRun](/fr/reference/system/xasync/functions/xasyncrun).

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

Handle de l'utilisateur qui envoie les invitations.

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

Spécifie une chaîne qui indique l'ID de configuration de service du titre.

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

Spécifie une chaîne qui indique le nom du modèle de session multijoueur.

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

Spécifie une chaîne qui indique l'ID de la session multijoueur à laquelle inviter des personnes.

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

Spécifie une chaîne qui indique l'ID de chaîne d'invitation personnalisée.<br />Cet ID de chaîne est défini dans la configuration de service XBOX Live pour identifier le texte d'invitation qui s'ajoute au texte d'invitation standard. La chaîne d'ID doit être préfixée par "///". Passez une chaîne vide si vous ne souhaitez pas ajouter de chaîne personnalisée à l'invitation.

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

Contexte d'activation personnalisé mis à la disposition de la personne invitée dans l'URI d'activation d'une invitation. La chaîne de contexte d'activation personnalisé doit être compatible avec les URL, et le contenu binaire doit être encodé avec un encodage base64 compatible avec les URL. La longueur maximale est de 160 caractères.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT de l'appel asynchrone.

## Remarques

Une fois la liste remplie, des joueurs peuvent être sélectionnés. Le joueur peut envoyer une invitation à jouer à un jeu et/ou à une conversation de groupe pour une session de jeu spécifiée aux personnes sélectionnées dans l'interface utilisateur de sélection.

L'appel d'une interface utilisateur fait passer votre jeu en *mode contraint*. En mode contraint, votre titre reçoit moins de ressources système lorsqu'il se trouve en arrière-plan de l'interface utilisateur appelée. Pour en savoir plus sur le mode contraint et les autres modes de fonctionnement de votre titre, consultez [Cycle de vie des jeux XBOX (rubrique sous NDA)](/fr/build/console-features/console-workflows/xbox-game-life-cycle).

## Configuration requise

**En-tête :** XGameUI.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Objectifs de conception et améliorations de la programmation asynchrone](/fr/build/core-features/common/async/async-whitepaper)
* [Envoi d'invitations](/fr/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## Voir aussi

[XGameUI](/fr/reference/system/xgameui/xgameui_members)<br />[XGameUiShowSendGameInviteResult](/fr/reference/system/xgameui/functions/xgameuishowsendgameinviteresult)<br />[Cycle de vie des jeux XBOX (rubrique sous NDA)](/fr/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)
- [XGameUiSetSendGameInviteUiResponse](/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse.md)
- [Sending invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [XGameUiUiCallbacks](/reference/system/xgameui/structs/xgameuiuicallbacks.md)