Skip to main content

XblMultiplayerManagerLobbySessionSetSynchronizedHost

XblMultiplayerSessionWriteMode::SynchronizedUpdate를 사용하여 로비 세션의 호스트를 설정합니다.

Syntax

Parameters

deviceToken   _In_
Type: char*
호스트의 디바이스 토큰입니다. context   _In_opt_
Type: void*
선택 사항. XblMultiplayerEvent를 시작 호출과 연관시키는 애플리케이션 정의 데이터입니다.

Return value

Type: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.

Remarks

이 함수는 로비 세션의 호스트를 설정합니다. 이 함수를 사용하여 원자성을 보장하고 동시에 호스트를 설정하려는 디바이스 간의 충돌을 해결합니다.
충돌로 인해 경합 상태가 발생하면 서비스가 호스트 설정 요청을 거부할 수 있습니다. 요청이 거부되면 서비스는 HTTP_E_STATUS_PRECOND_FAILED를 반환합니다. 충돌이 발생하면 호스트 변경 필요성을 다시 평가하고 필요한 경우 이 함수를 다시 호출하여 요청을 재제출합니다.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::SynchronizedHostWriteCompleted로 설정된 멀티플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다. 호스트 디바이스 토큰은 세션 멤버의 보안 디바이스 주소에서 생성되므로 이 메서드를 호출하기 전에 원하는 호스트에 대한 보안 디바이스 주소가 설정되어 있는지 확인합니다.

Requirements

Header: multiplayer_manager_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

multiplayer_manager_c
XblMultiplayerManagerLobbySessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress
마지막 수정일 2026년 8월 13일