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

Queries the visible multiplayer sessions based on the configuration of this request.

## Syntax

```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  
```

### Members

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

The service configuration id that the session is a part of.

*MaxItems*\
Type: uint32\_t

The maximum number of items to return.

*IncludePrivateSessions*\
Type: bool

Include private sessions to the result.

*IncludeReservations*\
Type: bool

Include sessions that the user hasn't accepted. Must specify xboxUserIdFilter to use.

*IncludeInactiveSessions*\
Type: bool

Include inactive sessions to the result. Must specify xboxUserIdFilter to use.

*XuidFilters*\
Type: uint64\_t\*

Filter result to just sessions these XBOX User IDs in it. (Optional) You must specify at least one Xuid filter OR a keyword filter.

*XuidFiltersCount*\
Type: size\_t

The number of Xuids in the XuidsFilters array.

*KeywordFilter*\
Type: const char\*

Filter result to just sessions with this keyword. (Optional) You must specify at least one Xuid filter OR a keyword filter.

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

The name of the template for the multiplayer session to filter on.

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

Filter result to just sessions with the specified visibility.

*ContractVersionFilter*\
Type: uint32\_t

Filter result to just sessions with this major version or less of the contract. Use 0 to ignore.

## Requirements

**Header:** multiplayer\_c.h

## See also

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


## Related topics

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