Skip to main content

XblMultiplayerGetSearchHandlesAsync

関連付けられている検索ハンドルによってセッションを検索します。

構文

パラメーター

xblContext   _In_
型: XblContextHandle
ローカル ユーザーの XBOX Live コンテキスト。 scid   _In_z_
型: char*
検索ハンドルを照会するサービス構成 ID (SCID)。SCID は大文字と小文字が区別されるので、パートナー センターから直接貼り付けてください。 sessionTemplateName   _In_z_
型: char*
検索ハンドルを照会するテンプレートの名前。 orderByAttribute   _In_opt_z_
型: char*
検索ハンドルを並べ替える属性を指定します。既定で ‘Timestamp asc’ で並べ替えるには、空の文字列を渡してください。 orderAscending   _In_
型: bool
昇順で並べ替えるには true、降順で並べ替えるには false を渡します。 searchFilter   _In_opt_z_
型: char*
検索ハンドルを取得するためのクエリ文字列。 socialGroup   _In_opt_z_
型: char*
検索ハンドルを取得するソーシャル グループ。 async   _In_
型: XAsyncBlock*
この操作用の AsyncBlock。

戻り値

型: HRESULT この API 操作の HRESULT 戻り値コード。

解説

検索ハンドルのフィルター: クエリ構文は OData に似た構文で、サポートされている演算子は EQ、NE、GE、GT、LE、LT と、論理演算子 AND および OR のみです。例 1: 特定の XboxUserId の検索ハンドルをフィルターするには、“MemberXuids/any(d:d eq ‘12345678’)” または “OwnerXuids/any(d:d eq ‘12345678’)” を使用します。例 2: タイトルで定義された文字列メタデータの検索ハンドルをフィルターするには、“Strings/stringMetadataType eq ‘value’” を使用します。例 3: タイトルで定義された数値メタデータとタグ型の値の検索ハンドルをフィルターするには、“Numbers/numberMetadataType eq 53 AND Tags/tagType eq ‘value’” を使用します。空のフィルターとソーシャル グループ: searchFilter と socialGroup はオプションのため、必要ない/使用しない場合は必ず nullptr を渡してください。空の文字列 "" を渡しても機能しません

要件

ヘッダー: multiplayer_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_c
最終更新日 2026年8月24日