> ## 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::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 に設定された [PFLobbyAddMemberCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) が提供されます。<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](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PFLobbyGetMemberProperty](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)
- [PFLobbyGetMemberPropertyKeys](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyDisconnectingStateChange](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydisconnectingstatechange.md)
- [PFLobbyGetMemberConnectionStatus](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)