> ## 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/ja-jp/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/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) で取得できます。

## 備考

これは非同期操作です。正常に完了すると、タイトルには [PFLobbyMemberAddedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md) の後に、[PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) フィールドが `S_OK` に設定された [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) が提供されます。失敗した完了の場合、タイトルには [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) フィールドが失敗 hresult に設定された [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) が提供されます。\
\
 このメソッドは、既存のロビー オブジェクトに別のローカル PlayFab エンティティを追加するために使用します。ロビー オブジェクトは、[PFMultiplayerCreateAndJoinLobby](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md) または [PFMultiplayerJoinLobby](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) の呼び出しによって既に作成されている必要があるため、このメソッドは主に複数ローカル ユーザーのシナリオで有用です。\
\
 これは非同期操作です。このメソッドで追加されたメンバーは、非同期操作が正常に完了して [PFMultiplayerStartProcessingLobbyStateChanges](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) によって `PFLobbyMemberAddedStateChange` 構造体が提供されるまで、[PFLobbyGetMembers](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md) から返されるリストには反映されません。

## 要件

**ヘッダー:** PFLobby.h

## 関連項目

[PFLobby メンバー](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

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