> ## 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 muestra una interfaz de usuario de selección rellenada a partir de la lista de amigos y la lista de amigos sugeridos del jugador seleccionado para enviar invitaciones de juego.

## Sintaxis

```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\*](/reference/system/xasync/structs/xasyncblock)

Un puntero al [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) que se pasa a [XAsyncRun](/reference/system/xasync/functions/xasyncrun).

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

Un identificador del usuario que envía las invitaciones.

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

Especifica una cadena que indica el identificador de configuración de servicio del título.

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

Especifica una cadena que indica el nombre de la plantilla de sesión multijugador.

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

Especifica una cadena que indica el identificador de la sesión multijugador a la que se invitará a las personas.

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

Especifica una cadena que indica el identificador de cadena de invitación personalizada.<br />Este identificador de cadena se define en la configuración del servicio de XBOX Live para identificar el texto de invitación adicional al texto de invitación estándar. La cadena de identificador debe tener el prefijo "///". Pase una cadena vacía si no desea agregar una cadena personalizada a la invitación.

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

El contexto de activación personalizado que está disponible para el invitado en el URI de activación de una invitación. La cadena de contexto de activación personalizado debe ser segura para direcciones URL y el contenido binario debe codificarse con codificación base64 segura para direcciones URL. La longitud máxima es de 160 caracteres.

### Valor devuelto

Tipo: HRESULT

HRESULT de éxito o código de error de la llamada asincrónica.

## Comentarios

Una vez que la lista se rellena, se pueden seleccionar jugadores. El jugador puede enviar una invitación para jugar a un juego o para un chat de grupo de una sesión de juego especificada a las personas seleccionadas en la interfaz de usuario de selección.

Llamar a la interfaz de usuario hará que el juego entre en *modo restringido*. En modo restringido, el título recibirá menos recursos del sistema mientras esté en segundo plano respecto de la interfaz de usuario que se haya invocado. Para obtener más información sobre el modo restringido y otros modos operativos del título, lea [Ciclo de vida del juego de XBOX (tema NDA)](/build/console-features/console-workflows/xbox-game-life-cycle).

## Requisitos

**Encabezado:** XGameUI.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Objetivos de diseño y mejoras de la programación asincrónica](/build/core-features/common/async/async-whitepaper)
* [Envío de invitaciones](/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## Consulte también

[XGameUI](/reference/system/xgameui/xgameui_members)<br />[XGameUiShowSendGameInviteResult](/reference/system/xgameui/functions/xgameuishowsendgameinviteresult)<br />[Ciclo de vida del juego de XBOX (tema NDA)](/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowSendGameInviteUiCallback](/es/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback.md)
- [XGameUiSetSendGameInviteUiResponse](/es/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse.md)
- [XGameUiUiCallbacks](/es/reference/system/xgameui/structs/xgameuiuicallbacks.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XGameUI](/es/reference/system/xgameui/xgameui_members.md)