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

> 그룹 또는 역할에 멤버를 추가합니다.

그룹 또는 역할에 멤버를 추가합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

비동기 작업을 위한 XAsyncBlock입니다.

### 반환 값

형식: HRESULT

이 API 작업의 결과 코드입니다.

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 그룹 또는 역할에 멤버를 추가합니다. 그룹의 기존 멤버는 그룹 내의 역할에 추가되지만, 사용자가 아직 그룹의 멤버가 아닌 경우 title 클레임을 가진 주체만 그룹에 추가할 수 있으며, 다른 사용자는 그룹 신청 또는 초대 시스템을 사용하여 새 멤버를 그룹에 추가해야 합니다. 성공하면 아무것도 반환하지 않습니다. GroupApplyToGroupAsync, GroupInviteToGroupAsync, GroupListGroupMembersAsync, GroupRemoveMembersAsync도 참조하세요. XAsyncGetStatus를 호출하여 작업 상태를 가져옵니다. 서비스 호출이 실패하면 비동기 결과는 E\_PF\_ROLE\_DOES\_NOT\_EXIST 또는 전역 PlayFab 서비스 오류 중 하나가 됩니다. 오류 처리에 대한 자세한 내용은 “Handling PlayFab Errors” 문서 페이지를 참조하세요.

## 요구 사항

**헤더:** PFGroups.h

## 참고 항목

[PFGroups 멤버](/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

- [Services C API overview - PFGroups.h](/ko/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsRemoveMembersAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsremovemembersasync.md)
- [PFGroupsChangeMemberRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [PFGroupsAddMembersRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsaddmembersrequest.md)
- [PFGroupsIsMemberAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsismemberasync.md)