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

# XblMultiplayerSendInvitesAsync

> XblMultiplayerSendInvitesAsync

# XblMultiplayerSendInvitesAsync

Convida os usuários especificados para uma sessão. Isso fará com que uma notificação seja exibida a cada usuário convidado usando o texto de convite padrão. Se um usuário aceitar essa notificação, o título será ativado.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerSendInvitesAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionReference,  
         const uint64_t* xuids,  
         size_t xuidsCount,  
         uint32_t titleId,  
         const char* contextStringId,  
         const char* customActivationContext,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xblContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto do XBOX Live para o usuário local.

*sessionReference*   \_In\_\
Tipo: [XblMultiplayerSessionReference\*](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

Um objeto XblMultiplayerSessionReference que representa a sessão para a qual os usuários de destino serão convidados.

*xuids*   \_In\_\
Tipo: uint64\_t\*

A lista de IDs de usuário do Xbox que serão convidados.

*xuidsCount*   \_In\_\
Tipo: size\_t

Tamanho da matriz de xuids.

*titleId*   \_In\_\
Tipo: uint32\_t

A ID do título que o usuário convidado ativará para ingressar na sessão.

*contextStringId*   \_In\_opt\_z\_\
Tipo: char\*

A ID da cadeia de caracteres de contexto personalizada. Essa ID de cadeia de caracteres é definida durante a ingestã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 nullptr se você não quiser adicionar uma cadeia de caracteres personalizada ao convite.

*customActivationContext*   \_In\_opt\_z\_\
Tipo: char\*

A cadeia de caracteres de contexto de ativação. Uma cadeia de caracteres definida pelo jogo que é passada ao cliente de jogo convidado e interpretada conforme desejado. (Opcional)

*async*   \_In\_\
Tipo: XAsyncBlock\*

O AsyncBlock para esta operação.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Requisitos

**Cabeçalho:** multiplayer\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Documentação conceitual

* [Enviando convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## Confira também

[multiplayer\_c](/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [Enviando convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Visão geral do Multiplayer Session Directory](/pt-BR/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Tarefas de multijogador](/pt-BR/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Práticas recomendadas para chamar os serviços do XBOX](/pt-BR/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)