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

# XblMultiplayerSessionQuery

> XblMultiplayerSessionQuery

# XblMultiplayerSessionQuery

このリクエストの構成に基づいて、可視のマルチプレイヤー セッションに対してクエリを実行します。

## 構文

```cpp theme={null}
typedef struct XblMultiplayerSessionQuery {  
    char Scid[XBL_SCID_LENGTH];  
    uint32_t MaxItems;  
    bool IncludePrivateSessions;  
    bool IncludeReservations;  
    bool IncludeInactiveSessions;  
    uint64_t* XuidFilters;  
    size_t XuidFiltersCount;  
    const char* KeywordFilter;  
    char SessionTemplateNameFilter[XBL_MULTIPLAYER_SESSION_TEMPLATE_NAME_MAX_LENGTH];  
    XblMultiplayerSessionVisibility VisibilityFilter;  
    uint32_t ContractVersionFilter;  
} XblMultiplayerSessionQuery  
```

### メンバー

*Scid*\
型: char\[XBL\_SCID\_LENGTH]

セッションが属するサービス構成 ID。

*MaxItems*\
型: uint32\_t

返すアイテムの最大数。

*IncludePrivateSessions*\
型: bool

結果にプライベート セッションを含めます。

*IncludeReservations*\
型: bool

ユーザーがまだ承諾していないセッションを含めます。使用するには xboxUserIdFilter を指定する必要があります。

*IncludeInactiveSessions*\
型: bool

結果に非アクティブなセッションを含めます。使用するには xboxUserIdFilter を指定する必要があります。

*XuidFilters*\
型: uint64\_t\*

これらの XBOX ユーザー ID を含むセッションのみに結果をフィルタリングします。(オプション) 少なくとも 1 つの Xuid フィルターまたはキーワード フィルターを指定する必要があります。

*XuidFiltersCount*\
型: size\_t

XuidsFilters 配列内の Xuid の数。

*KeywordFilter*\
型: const char\*

このキーワードを持つセッションのみに結果をフィルタリングします。(オプション) 少なくとも 1 つの Xuid フィルターまたはキーワード フィルターを指定する必要があります。

*SessionTemplateNameFilter*\
型: char\[XBL\_MULTIPLAYER\_SESSION\_TEMPLATE\_NAME\_MAX\_LENGTH]

フィルタリングするマルチプレイヤー セッションのテンプレートの名前。

*VisibilityFilter*\
型: [XblMultiplayerSessionVisibility](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionvisibility)

指定した可視性を持つセッションのみに結果をフィルタリングします。

*ContractVersionFilter*\
型: uint32\_t

このメジャー コントラクト バージョン以下のセッションのみに結果をフィルタリングします。無視するには 0 を使用します。

## 要件

**ヘッダー:** multiplayer\_c.h

## 関連項目

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionVisibility](/ja-jp/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionvisibility.md)
- [XblMultiplayerQuerySessionsAsync](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerquerysessionsasync.md)
- [XblMultiplayerSessionQueryResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionqueryresult.md)
- [XblMultiplayerQuerySessionsResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerquerysessionsresult.md)
- [XblMultiplayerQuerySessionsResultCount](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerquerysessionsresultcount.md)