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

# XblMultiplayerSearchHandleGetStringAttributes

> XblMultiplayerSearchHandleGetStringAttributes

# XblMultiplayerSearchHandleGetStringAttributes

获取指向随搜索句柄附加的属性数组的指针。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerSearchHandleGetStringAttributes(  
         XblMultiplayerSearchHandle handle,  
         const XblMultiplayerSessionStringAttribute** attributes,  
         size_t* attributesCount  
)  
```

### 参数

*handle*   \_In\_\
类型：[XblMultiplayerSearchHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersearchhandle)

指向搜索句柄详细信息的句柄。

*attributes*   \_Out\_\
类型：[XblMultiplayerSessionStringAttribute\*\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionstringattribute)

回传指向属性数组的指针。该指针指向的内存在 XblMultiplayerSessionHandle 对象关闭之前的整个生命周期内均有效。

*attributesCount*   \_Out\_\
类型：size\_t\*

回传数组中的属性数量。

### 返回值

类型：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

- [XblMultiplayerSearchHandleGetNumberAttributes](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersearchhandlegetnumberattributes.md)
- [XblMultiplayerGetSearchHandlesAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
- [XblMultiplayerGetSearchHandlesResult](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerSearchHandleGetTags](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersearchhandlegettags.md)
- [XblMultiplayerSearchHandleGetVisibility](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersearchhandlegetvisibility.md)