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 を含むセッションだけになるように、結果をフィルター処理します。 (オプション) 少なくとも 1 つの Xuid フィルターまたはキーワード フィルターを指定する必要があります。

XuidFiltersCount
型: size_t

XuidsFilters 配列内の xuid の数。

KeywordFilter
型: const char*

このキーワードを持つセッションだけになるように、結果をフィルター処理します。 (オプション) 少なくとも 1 つの Xuid フィルターまたはキーワード フィルターを指定する必要があります。

SessionTemplateNameFilter
型: char[XBL_MULTIPLAYER_SESSION_TEMPLATE_NAME_MAX_LENGTH]

フィルターの対象になるマルチプレイヤー セッションのテンプレートの名前。

VisibilityFilter
型: XblMultiplayerSessionVisibility

指定した可視性を持つセッションだけになるように、結果をフィルター処理します。

ContractVersionFilter
型: uint32_t

コントラクトのメジャー バージョンがこのバージョン以下のセッションだけになるように、結果をフィルター処理します。 コントラクト バージョンを無視するには、0 を使用します。

要件

ヘッダー: multiplayer_c.h

関連項目

multiplayer_c