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

# XblMultiplayerCreateSearchHandleAsync

> XblMultiplayerCreateSearchHandleAsync

# XblMultiplayerCreateSearchHandleAsync

既存のセッションに関連付けられた検索ハンドルを作成します。これにより、セッションが照会可能になります。

## 構文

```cpp theme={null}
HRESULT XblMultiplayerCreateSearchHandleAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionRef,  
         const XblMultiplayerSessionTag* tags,  
         size_t tagsCount,  
         const XblMultiplayerSessionNumberAttribute* numberAttributes,  
         size_t numberAttributesCount,  
         const XblMultiplayerSessionStringAttribute* stringAttributes,  
         size_t stringAttributesCount,  
         XAsyncBlock* async  
)  
```

### パラメーター

*xblContext*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

ローカル ユーザーの XBOX live コンテキスト。

*sessionRef*   \_In\_\
型: [XblMultiplayerSessionReference\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

検索ハンドルを作成するセッション参照。

*tags*   \_In\_reads\_opt\_(tagsCount)\
型: [XblMultiplayerSessionTag\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessiontag)

検索ハンドルに関連付ける任意のタグ セット。

*tagsCount*   \_In\_\
型: size\_t

タグの数。

*numberAttributes*   \_In\_reads\_opt\_(numberAttributesCount)\
型: [XblMultiplayerSessionNumberAttribute\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionnumberattribute)

検索ハンドルに関連付ける任意の属性。

*numberAttributesCount*   \_In\_\
型: size\_t

数値属性の数。

*stringAttributes*   \_In\_reads\_opt\_(stringAttributesCount)\
型: [XblMultiplayerSessionStringAttribute\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionstringattribute)

検索ハンドルに関連付ける任意の属性。

*stringAttributesCount*   \_In\_\
型: size\_t

文字列属性の数。

*async*   \_In\_\
型: XAsyncBlock\*

この操作用の AsyncBlock。

### 戻り値

型: HRESULT

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

## 要件

**ヘッダー:** multiplayer\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

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


## Related topics

- [XblMultiplayerCreateSearchHandleResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleresult.md)
- [XblMultiplayerDeleteSearchHandleAsync](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerGetSearchHandlesAsync](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerGetSearchHandlesResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)