> ## 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.

# PFMultiplayerConnectToLobby

> PlayFab Multiplayer C++ SDK 経由で、以前に追加されたロビーにローカル PlayFab エンティティを接続するための PFMultiplayerConnectToLobby リファレンス。

ローカル PlayFab エンティティが既にメンバーとして追加されているロビーに接続します。

## 構文

```cpp theme={null}
HRESULT PFMultiplayerConnectToLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* newMember,  
    const char* lobbyId,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### パラメーター

**`handle`**   PFMultiplayerHandle

PFMultiplayer API インスタンスのハンドル。

**`newMember`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

ロビーに接続するローカル エンティティ。

**`lobbyId`**   char\*\
*null 終端*

接続対象のロビー ID。

**`asyncContext`**   void\*\
*省略可能*

完了状態の変化をこの呼び出しに関連付けるために使用できる、アプリ定義のポインター サイズのコンテキスト値 (省略可能)。

**`lobby`**   PFLobbyHandle\*\
*省略可能、ライブラリが割り当てる出力*

この操作の完了に対して即時に実行する操作をキューに登録するために使用できる、省略可能なロビー オブジェクトの出力。

### 戻り値

型: HRESULT

呼び出しが成功した場合は `S_OK`、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、[PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) を通じて取得できます。

## 解説

これは非同期操作です。正常に完了すると、タイトルには [PFLobbyMemberAddedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange) が提供され、その後に [PFLobbyUpdatedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange)、および [PFLobbyConnectToLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyconnecttolobbycompletedstatechange) フィールドが `S_OK` に設定された [PFLobbyConnectToLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyconnecttolobbycompletedstatechange) が提供されます。失敗して完了した場合、タイトルには [PFLobbyConnectToLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyconnecttolobbycompletedstatechange) フィールドが失敗に設定された [PFLobbyConnectToLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyconnecttolobbycompletedstatechange) が提供されます。

## 要件

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

## 関連項目

[PFLobby メンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PlayFab Multiplayer C++ SDK リリース ノート](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 概要 - PFLobby.h](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PFLobbyStateChangeType](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)
- [PFLobbyConnectToLobbyCompletedStateChange](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyconnecttolobbycompletedstatechange.md)
- [Lobby.ConnectionString](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/ConnectionString.md)