> ## 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-CA/reference/system/xasync/structs/xasyncblock)

Pointeur vers le [XAsyncBlock](/fr-CA/reference/system/xasync/structs/xasyncblock) qui est passé à [XAsyncRun](/fr-CA/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 la chaîne d'invitation personnalisée.<br />Cet ID de chaîne est défini dans la configuration du 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écédée de "///". Passez une chaîne vide si vous ne voulez pas qu'une chaîne personnalisée soit ajoutée à l'invitation.

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

Le contexte d'activation personnalisé qui est accessible à la personne invitée dans l'URI d'activation d'une invitation. La chaîne du 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 fera passer votre jeu en *mode limité*. En mode limité, votre titre recevra moins de ressources système pendant qu'il se trouve en arrière-plan de l'interface utilisateur appelée. Pour en savoir plus sur le mode limité et les autres modes de fonctionnement de votre titre, consultez [Cycle de vie des jeux XBOX (rubrique sous NDA)](/fr-CA/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-CA/build/core-features/common/async/async-whitepaper)
* [Envoi d'invitations](/fr-CA/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## Voir aussi

[XGameUI](/fr-CA/reference/system/xgameui/xgameui_members)<br />[XGameUiShowSendGameInviteResult](/fr-CA/reference/system/xgameui/functions/xgameuishowsendgameinviteresult)<br />[Cycle de vie des jeux XBOX (rubrique sous NDA)](/fr-CA/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)