> ## 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-TW/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-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

這是一項非同步作業。成功完成時，遊戲會收到 [PFLobbyMemberAddedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)，接著收到 [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) 欄位設定為 `S_OK` 的 [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md)。 失敗完成時，遊戲會收到 [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) 欄位設定為失敗 HRESULT 的 [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md)。 \
\
 此方法用於將另一個本機 PlayFab 實體新增至既有的大廳物件。由於大廳物件必須已透過呼叫 [PFMultiplayerCreateAndJoinLobby](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md) 或 [PFMultiplayerJoinLobby](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) 建立，因此此方法主要適用於多個本機使用者的情境。   \
\
 這是一項非同步作業。在非同步作業成功完成且 [PFMultiplayerStartProcessingLobbyStateChanges](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供 `PFLobbyMemberAddedStateChange` 結構之前，透過此方法新增的成員不會反映在 [PFLobbyGetMembers](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md) 所傳回的清單中。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

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