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