다음을 통해 공유

XblMultiplayerManagerLobbySessionSetSynchronizedProperties

  • 아티클

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

구문

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

요구 사항

헤더: multiplayer_manager_c.h

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

참고 항목

multiplayer_manager_c
XblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent