> ## 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](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本機使用者的 XBOX Live 內容。

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

要為其建立搜尋控制代碼的工作階段參考。

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

要附加至搜尋控制代碼的選擇性標籤集合。

*tagsCount*   \_In\_\
類型：size\_t

標籤的計數。

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

要附加至搜尋控制代碼的選擇性屬性。

*numberAttributesCount*   \_In\_\
類型：size\_t

數字屬性的計數。

*stringAttributes*   \_In\_reads\_opt\_(stringAttributesCount)\
類型：[XblMultiplayerSessionStringAttribute\*](/zh-TW/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](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerCreateSearchHandleResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleresult.md)
- [多人遊戲工作階段瀏覽](/zh-TW/services/xbox-services/multiplayer/concepts/live-session-browse.md)
- [XblMultiplayerDeleteSearchHandleAsync](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)
- [XblMultiplayerGetSearchHandlesAsync](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerGetSearchHandlesResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)