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

- [멀티플레이어 작업](/ko/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSessionSetServerConnectionStringCandidates](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetserverconnectionstringcandidates.md)
- [XblMultiplayerManagerGameSessionHost](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionhost.md)
- [XblMultiplayerManagerGameSessionIsHost](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionishost.md)
- [XblMultiplayerManagerLobbySessionIsHost](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)