> ## 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](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange),其 [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。<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](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PFLobbyGetMemberProperty](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)
- [PFLobbyGetMemberPropertyKeys](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyDisconnectingStateChange](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydisconnectingstatechange.md)
- [PFLobbyGetMemberConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)