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

이 요청의 구성에 따라 표시되는 멀티플레이어 세션을 쿼리합니다.

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

세션이 속한 서비스 구성 ID입니다.

*MaxItems*\
Type: uint32\_t

반환할 최대 항목 수입니다.

*IncludePrivateSessions*\
Type: bool

결과에 프라이빗 세션을 포함합니다.

*IncludeReservations*\
Type: bool

사용자가 수락하지 않은 세션을 포함합니다. 사용하려면 xboxUserIdFilter를 지정해야 합니다.

*IncludeInactiveSessions*\
Type: bool

결과에 비활성 세션을 포함합니다. 사용하려면 xboxUserIdFilter를 지정해야 합니다.

*XuidFilters*\
Type: uint64\_t\*

결과를 이 XBOX User ID가 포함된 세션으로만 필터링합니다. (선택 사항) 하나 이상의 Xuid 필터 또는 키워드 필터를 지정해야 합니다.

*XuidFiltersCount*\
Type: size\_t

XuidsFilters 배열의 Xuid 수입니다.

*KeywordFilter*\
Type: const char\*

결과를 이 키워드가 있는 세션으로만 필터링합니다. (선택 사항) 하나 이상의 Xuid 필터 또는 키워드 필터를 지정해야 합니다.

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

필터링할 멀티플레이어 세션의 템플릿 이름입니다.

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

결과를 지정된 표시 유형이 있는 세션으로만 필터링합니다.

*ContractVersionFilter*\
Type: uint32\_t

결과를 이 계약 주요 버전 이하가 있는 세션으로만 필터링합니다. 무시하려면 0을 사용합니다.

## Requirements

**Header:** multiplayer\_c.h

## See also

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


## Related topics

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