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

# XblMultiplayerGetSearchHandlesAsync

> XblMultiplayerGetSearchHandlesAsync

# XblMultiplayerGetSearchHandlesAsync

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

## 構文

```cpp theme={null}
HRESULT XblMultiplayerGetSearchHandlesAsync(  
         XblContextHandle xblContext,  
         const char* scid,  
         const char* sessionTemplateName,  
         const char* orderByAttribute,  
         bool orderAscending,  
         const char* searchFilter,  
         const char* socialGroup,  
         XAsyncBlock* async  
)  
```

### パラメーター

*xblContext*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerGetSearchHandlesResultCount](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)
- [XblMultiplayerGetSearchHandlesResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerCreateSearchHandleAsync](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)
- [XblMultiplayerDeleteSearchHandleAsync](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)