> ## 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](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleresult.md)
- [XblMultiplayerGetSearchHandlesAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerDeleteSearchHandleAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerGetSearchHandlesResult](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)