다음을 통해 공유


XblMultiplayerSessionQuery

이 요청의 구성을 기준으로 표시 가능한 멀티 플레이 세션을 쿼리합니다.

구문

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

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

ContractVersionFilter
형식: uint32_t

계약의 이 주 버전까지 포함된 세션으로만 결과를 필터링합니다. 무시하려면 0을 사용합니다.

요구 사항

헤더: multiplayer_c.h

참고

multiplayer_c