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

# PFMultiplayerFindLobbies

> PlayFab Multiplayer C++ SDK のフィルターおよび並べ替え文字列を使用して、ローカル ユーザーに代わって PlayFab ロビーを検索するための PFMultiplayerFindLobbies リファレンス。

ローカル ユーザーに代わってロビーを検索します。

## 構文

```cpp theme={null}
HRESULT PFMultiplayerFindLobbies(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* searchingEntity,  
    const PFLobbySearchConfiguration* searchConfiguration,  
    void* asyncContext  
)  
```

### パラメーター

**`handle`**   PFMultiplayerHandle

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

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

検索を実行する PlayFab エンティティ。

**`searchConfiguration`**   [PFLobbySearchConfiguration\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchconfiguration)

検索対象のロビーを絞り込みおよび並べ替えするために使用する構成。

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

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

### 戻り値

型: HRESULT

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

## 解説

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

## 要件

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

## 関連項目

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


## Related topics

- [PFLobbySearchConfiguration](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchconfiguration.md)
- [PFLobbySearchResult](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchresult.md)
- [Integrate Party with Lobby using Multiplayer SDK](/ja-jp/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [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)