> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

要作为成员添加到大厅的本地用户的 PlayFab 实体键。

**`memberPropertyCount`**   uint32\_t
*输入,范围为 `0,PFLobbyMaxMemberPropertyCount`*

此用户加入大厅时要为其设置的初始成员属性数量。

**`memberPropertyKeys`**   char\* const\*
*大小为 `memberPropertyCount` 的输入数组*

此用户加入大厅时要为其设置的初始成员属性的键。

**`memberPropertyValues`**   char\* const\*
*大小为 `memberPropertyCount` 的输入数组*

此用户加入大厅时要为其设置的初始成员属性的值。

**`asyncContext`**   void\*
*可选*

一个可选的、由应用定义的、指针大小的上下文值,可用于将完成状态更改与此次调用相关联。

### 返回值

类型:HRESULT

如果调用成功,则为 `S_OK`,否则为错误代码。可通过 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 获取错误代码的可读形式。

## 备注

这是一个异步操作。成功完成时,游戏将获得一个 [PFLobbyMemberAddedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md),随后是一个 [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md),其 [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) 字段被设置为 `S_OK`。失败完成时,游戏将获得一个 [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md),其 [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) 字段被设置为失败的 hresult。\
\
 此方法用于将另一个本地 PlayFab 实体添加到已存在的大厅对象中。由于大厅对象必须已经通过调用 [PFMultiplayerCreateAndJoinLobby](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md) 或 [PFMultiplayerJoinLobby](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) 创建,因此此方法主要用于多本地用户的场景。\
\
 这是一个异步操作。通过此方法添加的成员在异步操作成功完成并且 [PFMultiplayerStartProcessingLobbyStateChanges](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供 `PFLobbyMemberAddedStateChange` 结构之前,不会反映在 [PFLobbyGetMembers](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md) 返回的列表中。

## 要求

**头文件:** PFLobby.h

## 另请参阅

[PFLobby 成员](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [PFLobbyMemberAddedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PFLobbyGetMemberProperty](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)
- [PFLobbyGetMemberPropertyKeys](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyDisconnectingStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydisconnectingstatechange.md)
- [PFLobbyGetMemberConnectionStatus](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)