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

Consulta as sessões multijogador visíveis com base na configuração desta solicitação.

## Sintaxe

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

### Membros

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

A ID de configuração de serviço da qual a sessão faz parte.

*MaxItems*\
Tipo: uint32\_t

O número máximo de itens a serem retornados.

*IncludePrivateSessions*\
Tipo: bool

Inclui sessões privadas no resultado.

*IncludeReservations*\
Tipo: bool

Inclui sessões que o usuário não aceitou. É necessário especificar xboxUserIdFilter para usar.

*IncludeInactiveSessions*\
Tipo: bool

Inclui sessões inativas no resultado. É necessário especificar xboxUserIdFilter para usar.

*XuidFilters*\
Tipo: uint64\_t\*

Filtra o resultado apenas para as sessões que contêm estas IDs de usuário do XBOX. (Opcional) Você deve especificar pelo menos um filtro de Xuid OU um filtro de palavra-chave.

*XuidFiltersCount*\
Tipo: size\_t

O número de Xuids na matriz XuidsFilters.

*KeywordFilter*\
Tipo: const char\*

Filtra o resultado apenas para as sessões com esta palavra-chave. (Opcional) Você deve especificar pelo menos um filtro de Xuid OU um filtro de palavra-chave.

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

O nome do modelo da sessão multijogador a ser usado como filtro.

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

Filtra o resultado apenas para as sessões com a visibilidade especificada.

*ContractVersionFilter*\
Tipo: uint32\_t

Filtra o resultado apenas para as sessões com esta versão principal do contrato ou inferior. Use 0 para ignorar.

## Requisitos

**Cabeçalho:** multiplayer\_c.h

## Confira também

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


## Related topics

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