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

# PFGroupsInviteToGroupAsync

> Convida um jogador para ingressar em um grupo

Convida um jogador para ingressar em um grupo

## Sintaxe

```cpp theme={null}
HRESULT PFGroupsInviteToGroupAsync(  
    PFEntityHandle entityHandle,  
    const PFGroupsInviteToGroupRequest* request,  
    XAsyncBlock* async  
)  
```

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

**`request`**   [PFGroupsInviteToGroupRequest\*](/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogrouprequest)

Objeto de solicitação preenchido.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível em todas as plataformas. Convida um jogador para ingressar em um grupo, caso ele não esteja bloqueado pelo grupo. Uma função opcional pode ser fornecida para atribuir automaticamente o jogador a essa função se ele aceitar o convite. Por padrão, se a entidade tiver uma candidatura pendente ao grupo, a candidatura será aceita e um erro indicando isso será retornado, em vez de criar um convite de ingresso duplicado que precisaria ser limpo posteriormente. Retorna informações sobre o novo convite ou um erro indicando que uma candidatura de ingresso existente foi aceita. Confira também GroupAcceptGroupInvitationAsync, GroupListGroupInvitationsAsync, GroupListMembershipOpportunitiesAsync, GroupRemoveGroupInvitationAsync. Quando a tarefa assíncrona for concluída, chame [PFGroupsInviteToGroupGetResultSize](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize) e [PFGroupsInviteToGroupGetResult](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult) para obter o resultado.

## Requisitos

**Cabeçalho:** PFGroups.h

## Confira também

[Membros de PFGroups](/pt-BR/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

- [PFGroupsInviteToGroupGetResult](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md)
- [Visão geral da API C do Services - PFGroups.h](/pt-BR/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [Invite To Group](/api-reference/groups/invite-to-group.md)
- [PFGroupsInviteToGroupGetResultSize](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md)
- [PFGroupsCreateGroupAsync](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupscreategroupasync.md)