> ## 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 的会话。（可选）必须至少指定一个 Xuid 过滤器或一个关键字过滤器。

*XuidFiltersCount*\
类型：size\_t

XuidsFilters 数组中的 Xuid 数量。

*KeywordFilter*\
类型：const char\*

将结果过滤到仅包含此关键字的会话。（可选）必须至少指定一个 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

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