XblMultiplayerCreateSearchHandleAsync

创建与现有会话关联的搜索句柄。 这使会话可查询。

语法

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

本地用户的 Xbox Live 上下文。

sessionRef _In_
类型:XblMultiplayerSessionReference*

要为其创建搜索句柄的会话引用。

tags _In_reads_opt_(tagsCount)
类型:XblMultiplayerSessionTag*

附加到搜索句柄的一组可选标签。

tagsCount _In_
类型:size_t

标签的计数。

numberAttributes _In_reads_opt_(numberAttributesCount)
类型:XblMultiplayerSessionNumberAttribute*

附加到搜索句柄的一组可选属性。

numberAttributesCount _In_
类型:size_t

数字属性的计数。

stringAttributes _In_reads_opt_(stringAttributesCount)
类型:XblMultiplayerSessionStringAttribute*

附加到搜索句柄的一组可选属性。

stringAttributesCount _In_
类型:size_t

字符串属性的计数。

async _In_
类型:XAsyncBlock*

此操作的 AsyncBlock。

返回值

类型:HRESULT

此 API 操作的 HRESULT 返回代码。

要求

头文件:multiplayer_c.h

库:Microsoft.Xbox.Services.141.GSDK.C.lib

另请参阅

multiplayer_c