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

# PFGroupsApplyToGroupAsync

> Solicita ingresso em um grupo

Solicita ingresso em um grupo

## Sintaxe

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

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

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

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. Cria uma solicitação para ingressar em um grupo. Chamar isso enquanto já existir uma solicitação de grupo retornará a mesma solicitação em vez de um erro e não renovará o tempo antes que a solicitação expire. Por padrão, se a entidade tiver um convite pendente para ingressar no grupo, isso aceitará o convite para ingressar no grupo e retornará um erro indicando isso, em vez de criar uma solicitação duplicada de ingresso que precisará ser limpa posteriormente. Retorna informações sobre a solicitação ou um erro indicando que um convite foi aceito em seu lugar. Consulte também GroupAcceptGroupApplicationAsync, GroupListGroupApplicationsAsync, GroupRemoveGroupApplicationAsync. Quando a tarefa assíncrona for concluída, chame [PFGroupsApplyToGroupGetResultSize](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresultsize) e [PFGroupsApplyToGroupGetResult](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresult) 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

- [PFGroupsApplyToGroupGetResult](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresult.md)
- [Visão geral da API C do Services - PFGroups.h](/pt-BR/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [Apply To Group](/api-reference/groups/apply-to-group.md)
- [PFGroupsApplyToGroupGetResultSize](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresultsize.md)
- [PFGroupsApplyToGroupResponse](/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsapplytogroupresponse.md)