XblMultiplayerManagerGameSessionSetSynchronizedProperties

XblMultiplayerSessionWriteMode::SynchronizedUpdate을(를) 사용하여 게임 세션에 대한 사용자 지정 속성의 값을 설정합니다.

구문

HRESULT XblMultiplayerManagerGameSessionSetSynchronizedProperties(  
         const char* name,  
         const char* valueJson,  
         void* context  
)  

매개 변수

name _In_z_
형식: char*

설정할 사용자 지정 속성의 이름입니다.

valueJson _In_z_
형식: char*

속성에 JSON 문자열로 할당할 값입니다.

context _In_opt_
형식: void*

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

반환 값

형식: HRESULT

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

비고

이 함수는 게임 세션에 대한 사용자 지정 속성의 JSON 문자열로 표현되는 값을 설정합니다. 사용자 지정 속성은 언제든지 변경할 수 있습니다. 사용자 지정 속성이 장치 간에 공유되거나 여러 장치에서 동시에 업데이트될 수 있는 경우 이 함수를 사용하여 원자성을 보장하고 장치 간의 충돌을 해결하는 동시에 해당 사용자 지정 속성의 값을 변경합니다. 사용자 지정 속성이 장치 간에 공유되지 않는 경우 XblMultiplayerManagerGameSessionSetProperties 함수를 대신 사용하여 해당 사용자 지정 속성의 값을 변경합니다.
충돌로 인해 경합 상태가 발생하는 경우 서비스에서 사용자 지정 속성 변경 요청을 거부할 수 있습니다. 요청이 거부되면 서비스는 HTTP_E_STATUS_PRECOND_FAILED을(를) 반환합니다. 충돌이 발생하는 경우 사용자 지정 속성을 변경해야 하는 필요성을 다시 평가하고 필요한 경우 이 함수를 다시 호출하여 요청을 다시 제출합니다.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted(으)로 설정된 멀티 플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티 플레이어 이벤트를 검색할 수 있습니다.

요구 사항

헤더: multiplayer_manager_c.h

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

참고 항목

multiplayer_manager_c
XblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent