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

# PFGroupsAddMembersRequest

> PFGroupsAddMembersRequest 데이터 모델입니다. 그룹 또는 역할에 멤버를 추가합니다. 그룹의 기존 멤버는 그룹 내 역할에 추가되지만, 사용자가.

PFGroupsAddMembersRequest 데이터 모델입니다. 그룹 또는 역할에 멤버를 추가합니다. 그룹의 기존 멤버는 그룹 내 역할에 추가되지만, 사용자가 아직 그룹의 멤버가 아닌 경우 타이틀 소유자만 사용자를 그룹에 추가할 수 있으며, 다른 사용자는 그룹 신청 또는 초대 시스템을 사용하여 새 멤버를 그룹에 추가해야 합니다. 성공한 경우 아무 것도 반환하지 않습니다.

## 구문

```cpp theme={null}
typedef struct PFGroupsAddMembersRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* roleId;  
} PFGroupsAddMembersRequest;  
```

### 멤버

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`group`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

그룹의 식별자입니다.

**`members`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

그룹에 추가할 엔터티 목록입니다. title\_player\_account 및 character 유형의 엔터티만 그룹에 추가할 수 있습니다.

**`membersCount`**   uint32\_t

members의 개수입니다.

**`roleId`**   const char\*<br />*is null-terminated*

(선택 사항) 선택 사항: 엔터티를 추가할 기존 역할의 ID입니다. 지정하지 않으면 그룹의 기본 멤버 역할이 사용됩니다. 역할 ID는 길이가 1\~64자여야 합니다.

## 요구 사항

**헤더:** PFGroupsTypes.h

## 참고 항목

[PFGroupsTypes 멤버](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)