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

工作階段所屬的服務設定識別碼。

*MaxItems*\
類型：uint32\_t

要傳回的項目數上限。

*IncludePrivateSessions*\
類型：bool

在結果中包含私人工作階段。

*IncludeReservations*\
類型：bool

包含使用者尚未接受的工作階段。必須指定 xboxUserIdFilter 才能使用。

*IncludeInactiveSessions*\
類型：bool

在結果中包含非作用中的工作階段。必須指定 xboxUserIdFilter 才能使用。

*XuidFilters*\
類型：uint64\_t\*

將結果篩選為僅包含這些 XBOX 使用者識別碼的工作階段。(選用) 您必須至少指定一個 Xuid 篩選條件或關鍵字篩選條件。

*XuidFiltersCount*\
類型：size\_t

XuidsFilters 陣列中的 Xuid 數目。

*KeywordFilter*\
類型：const char\*

將結果篩選為僅包含具有此關鍵字的工作階段。(選用) 您必須至少指定一個 Xuid 篩選條件或關鍵字篩選條件。

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

要作為篩選依據的多人遊戲工作階段範本名稱。

*VisibilityFilter*\
類型：[XblMultiplayerSessionVisibility](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionvisibility)

將結果篩選為僅包含具有指定可見性的工作階段。

*ContractVersionFilter*\
類型：uint32\_t

將結果篩選為僅包含合約主要版本為此版本或更低版本的工作階段。使用 0 表示忽略。

## 需求

**標頭：** multiplayer\_c.h

## 另請參閱

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


## Related topics

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