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

## 備註

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

## 需求

**標頭：** PFLobby.h

## 另請參閱

[PFLobby 成員](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

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