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

# PFGroupsChangeMemberRoleAsync

> 엔터티 목록의 역할 멤버십을 한 역할에서 다른 역할로 변경합니다.

엔터티 목록의 역할 멤버십을 한 역할에서 다른 역할로 변경합니다.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

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

### Return value

Type: HRESULT

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

## Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 엔터티 목록의 역할 멤버십을 한 역할에서 다른 역할로 단일 작업으로 변경합니다. 대상 역할이 이미 존재해야 합니다. 이는 엔터티를 대상 역할에 추가하고 원본 역할에서 제거하는 것과 동일합니다. 성공하면 아무 것도 반환하지 않습니다. 관련 항목: GroupAddMembersAsync, GroupCreateRoleAsync, GroupRemoveMembersAsync. XAsyncGetStatus를 호출하여 작업 상태를 가져옵니다. 서비스 호출이 실패한 경우, 비동기 결과는 E\_PF\_ROLE\_DOES\_NOT\_EXIST 또는 전역 PlayFab 서비스 오류 중 하나가 됩니다. 오류 처리에 대한 자세한 내용은 문서 페이지 "Handling PlayFab Errors"를 참조하십시오.

## Requirements

**Header:** PFGroups.h

## See also

[PFGroups members](/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)
- [PFGroupsChangeMemberRoleRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest.md)
- [PFGroupsCreateRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupscreateroleasync.md)
- [PFGroupsDeleteRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsdeleteroleasync.md)
- [PFGroupsUpdateRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)