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

# XblMultiplayerSessionHostCandidates

> XblMultiplayerSessionHostCandidates

# XblMultiplayerSessionHostCandidates

主机候选者是按会话常量中 XblMultiplayerMetrics 指定的偏好顺序排列的设备令牌有序列表。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerSessionHostCandidates(  
         XblMultiplayerSessionHandle handle,  
         const XblDeviceToken** deviceTokens,  
         size_t* deviceTokensCount  
)  
```

### 参数

*handle*   \_In\_\
类型: [XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

多人游戏会话的句柄。

*deviceTokens*   \_Out\_\
类型: [XblDeviceToken\*\*](/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

传回指向候选设备令牌数组的指针。该指针的内存在 XblMultiplayerSessionHandle 对象关闭之前始终有效。

*deviceTokensCount*   \_Out\_\
类型: size\_t\*

传回 deviceTokens 数组的大小。

### 返回值

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

- [多人游戏任务](/zh-CN/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSessionSetServerConnectionStringCandidates](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetserverconnectionstringcandidates.md)
- [XblMultiplayerManagerGameSessionHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionhost.md)
- [XblMultiplayerManagerGameSessionIsHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionishost.md)
- [XblMultiplayerManagerLobbySessionHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionhost.md)