XblMultiplayerManagerGameSessionSetSynchronizedHost

XblMultiplayerSessionWriteMode::SynchronizedUpdate을(를) 사용하여 게임 세션의 호스트를 설정합니다.

구문

HRESULT XblMultiplayerManagerGameSessionSetSynchronizedHost(  
         const char* deviceToken,  
         void* context  
)  

매개 변수

deviceToken _In_
형식: char*

호스트의 장치 토큰입니다.

context _In_opt_
형식: void*

선택 사항. XblMultiplayerEvent를 시작 호출과 연결하기 위해 응용 프로그램에서 정의된 데이터입니다.

반환 값

형식: HRESULT

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

비고

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

요구 사항

헤더: multiplayer_manager_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

multiplayer_manager_c
XblMultiplayerManagerGameSessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress