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

# PFGroupsAddMembersAsync

> Adiciona membros a um grupo ou função.

Adiciona membros a um grupo ou função.

## Sintaxe

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

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

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

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. Adiciona membros a um grupo ou função. Os membros existentes do grupo serão adicionados a funções dentro do grupo, mas, se o usuário ainda não for membro do grupo, somente os requerentes do título poderão adicioná-lo ao grupo, e outros deverão usar o sistema de solicitação ou de convite do grupo para adicionar novos membros a um grupo. Não retorna nada se for bem-sucedida. Consulte também GroupApplyToGroupAsync, GroupInviteToGroupAsync, GroupListGroupMembersAsync, GroupRemoveMembersAsync. Chame XAsyncGetStatus para obter o status da operação. Se a chamada de serviço não for bem-sucedida, o resultado assíncrono será E\_PF\_ROLE\_DOES\_NOT\_EXIST ou qualquer um dos erros globais do Serviço PlayFab. Consulte a página de documentação "Handling PlayFab Errors" para obter mais detalhes sobre o tratamento de erros.

## Requisitos

**Cabeçalho:** PFGroups.h

## Confira também

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


## Related topics

- [Visão geral da API C do Services - PFGroups.h](/pt-BR/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsRemoveMembersAsync](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsremovemembersasync.md)
- [Add Shared Group Members](/api-reference/shared-group-data/add-shared-group-members.md)
- [PFGroupsChangeMemberRoleAsync](/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [PFGroupsAddMembersRequest](/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsaddmembersrequest.md)