> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFGroupsInviteToGroupAsync

> 플레이어를 그룹에 초대합니다.

플레이어를 그룹에 초대합니다.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

**`request`**   [PFGroupsInviteToGroupRequest\*](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogrouprequest.md)

채워진 요청 개체입니다.

**`async`**   XAsyncBlock\*\
*Inout*

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

### Return value

Type: HRESULT

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

## Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 그룹에 의해 차단되지 않은 경우 플레이어를 그룹에 초대합니다. 선택 사항으로 역할을 제공하면 플레이어가 초대를 수락할 때 자동으로 해당 역할에 할당할 수 있습니다. 기본적으로 엔터티에 그룹에 대한 신청이 남아 있는 경우, 나중에 정리해야 하는 중복된 가입 초대를 생성하는 대신 기존 신청을 수락하고 그에 따른 오류를 반환합니다. 새 초대에 대한 정보 또는 기존 가입 신청이 수락되었음을 나타내는 오류를 반환합니다. 관련 항목: GroupAcceptGroupInvitationAsync, GroupListGroupInvitationsAsync, GroupListMembershipOpportunitiesAsync, GroupRemoveGroupInvitationAsync. 비동기 작업이 완료되면 [PFGroupsInviteToGroupGetResultSize](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md) 및 [PFGroupsInviteToGroupGetResult](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md)를 호출하여 결과를 가져옵니다.

## Requirements

**Header:** PFGroups.h

## See also

[PFGroups members](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/pfgroups_members.md)


## Related topics

- [PFGroupsInviteToGroupGetResult](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md)
- [Services C API overview - PFGroups.h](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [Invite To Group](https://docs.xbox.com/api-reference/groups/invite-to-group.md)
- [PFGroupsInviteToGroupGetResultSize](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md)
- [PFGroupsCreateGroupAsync](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupscreategroupasync.md)