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

# PFLobbyAddMember

> 타이틀이 만들거나 참여한 기존 로비에 로컬 사용자를 새 멤버로 추가하는 데 사용되는 PlayFab Multiplayer C++ SDK의 PFLobbyAddMember 참조입니다.

로컬 사용자를 멤버로 로비에 추가합니다.

## 구문

```cpp theme={null}
HRESULT PFLobbyAddMember(  
    PFLobbyHandle lobby,  
    const PFEntityKey* localUser,  
    uint32_t memberPropertyCount,  
    const char* const* memberPropertyKeys,  
    const char* const* memberPropertyValues,  
    void* asyncContext  
)  
```

### 매개 변수

**`lobby`**   PFLobbyHandle

로비의 핸들입니다.

**`localUser`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

로비에 멤버로 추가할 로컬 사용자의 PlayFab 엔터티 키입니다.

**`memberPropertyCount`**   uint32\_t\
*`0,PFLobbyMaxMemberPropertyCount` 범위 내 입력*

이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성의 수입니다.

**`memberPropertyKeys`**   char\* const\*\
*크기가 `memberPropertyCount`인 입력 배열*

이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성의 키입니다.

**`memberPropertyValues`**   char\* const\*\
*크기가 `memberPropertyCount`인 입력 배열*

이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성의 값입니다.

**`asyncContext`**   void\*\
*선택 사항*

이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다.

### 반환 값

형식: HRESULT

호출이 성공한 경우 `S_OK`이고, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage)를 통해 검색할 수 있습니다.

## 설명

이 작업은 비동기 작업입니다. 성공적으로 완료되면 타이틀에는 [PFLobbyMemberAddedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange)와 [PFLobbyAddMemberCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) 필드가 `S_OK`로 설정된 [PFLobbyAddMemberCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange)가 순서대로 제공됩니다. 완료에 실패하면 타이틀에는 [PFLobbyAddMemberCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) 필드가 실패 hresult로 설정된 [PFLobbyAddMemberCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange)가 제공됩니다. <br /><br /> 이 메서드는 이미 존재하는 로비 개체에 다른 로컬 PlayFab 엔터티를 추가하는 데 사용됩니다. 로비 개체는 [PFMultiplayerCreateAndJoinLobby](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby) 또는 [PFMultiplayerJoinLobby](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby) 호출을 통해 이미 만들어져 있어야 하므로, 이 메서드는 주로 여러 로컬 사용자 시나리오에 유용합니다.   <br /><br /> 이 작업은 비동기 작업입니다. 이 메서드를 통해 추가된 멤버는 비동기 작업이 성공적으로 완료되고 [PFMultiplayerStartProcessingLobbyStateChanges](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges)에서 `PFLobbyMemberAddedStateChange` 구조체를 제공할 때까지 [PFLobbyGetMembers](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers)에서 반환하는 목록에 반영되지 않습니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

[PFLobby 멤버](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyMemberAddedStateChange](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PFLobbyGetMemberProperty](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)
- [PFLobbyGetMemberPropertyKeys](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyDisconnectingStateChange](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydisconnectingstatechange.md)
- [PFLobbyGetMemberConnectionStatus](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)