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

多人遊戲工作階段的控制代碼。

*deviceTokens*   \_Out\_\
類型：[XblDeviceToken\*\*](/zh-TW/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](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [多人遊戲工作](/zh-TW/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSessionSetServerConnectionStringCandidates](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetserverconnectionstringcandidates.md)
- [XblMultiplayerManagerLobbySessionIsHost](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)
- [XblMultiplayerManagerGameSessionHost](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionhost.md)
- [XblMultiplayerManagerGameSessionIsHost](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionishost.md)