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

# PFGroupsInviteToGroupAsync

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

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

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

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

### Return value

Type: HRESULT

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

## Remarks

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

## Requirements

**Header:** PFGroups.h

## See also

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


## Related topics

- [PFGroupsInviteToGroupGetResult](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md)
- [Services C API overview - PFGroups.h](/ko/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsInviteToGroupGetResultSize](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md)
- [PFGroupsInviteToGroupResponse](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogroupresponse.md)
- [PFGroupsCreateGroupAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupscreategroupasync.md)