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

# PFGroupsApplyToGroupAsync

> 그룹 참가를 신청합니다.

그룹 참가를 신청합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 그룹 참가를 위한 신청을 만듭니다. 이미 그룹 신청이 있는 상태에서 이를 호출하면 오류 대신 동일한 신청이 반환되며, 신청 만료 전까지의 시간은 갱신되지 않습니다. 기본적으로, 엔터티에 그룹 참가에 대한 미결 초대가 있는 경우 신청 대신 그룹 참가 초대가 수락되고, 나중에 정리해야 할 중복 참가 신청을 만드는 대신 이를 나타내는 오류가 반환됩니다. 신청에 대한 정보 또는 초대가 대신 수락되었음을 나타내는 오류를 반환합니다. GroupAcceptGroupApplicationAsync, GroupListGroupApplicationsAsync, GroupRemoveGroupApplicationAsync도 참조하세요. 비동기 작업이 완료되면 [PFGroupsApplyToGroupGetResultSize](/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresultsize)와 [PFGroupsApplyToGroupGetResult](/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFGroups.h

## 참고 항목

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


## Related topics

- [PFGroupsApplyToGroupGetResult](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresult.md)
- [Services C API overview - PFGroups.h](/ko/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsApplyToGroupGetResultSize](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsapplytogroupgetresultsize.md)
- [PFGroupsApplyToGroupResponse](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsapplytogroupresponse.md)
- [PFGroupsApplyToGroupRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsapplytogrouprequest.md)
