Pular para o conteúdo principal

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

Parâmetros

xblContext   _In_
Tipo: XblContextHandle
Contexto do XBOX Live para o usuário local. sessionReference   _In_
Tipo: 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

Confira também

multiplayer_c
Última modificação em 6 de outubro de 2026