XblMultiplayerManagerLobbySessionSetSynchronizedProperties
XblMultiplayerSessionWriteMode::SynchronizedUpdate를 사용하여 로비 세션의 사용자 지정 속성 값을 설정합니다.
Syntax
Parameters
name _In_z_Type: char* 설정할 사용자 지정 속성의 이름입니다. valueJson _In_z_
Type: char* JSON 문자열로 속성에 할당할 값입니다. context _In_opt_
Type: void* 선택 사항. XblMultiplayerEvent를 시작 호출과 연관시키는 애플리케이션 정의 데이터입니다.
Return value
Type: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.Remarks
이 함수는 로비 세션의 사용자 지정 속성 값을 JSON 문자열로 표현하여 설정합니다. 사용자 지정 속성은 언제든지 변경할 수 있습니다. 사용자 지정 속성이 디바이스 간에 공유되거나 여러 디바이스에서 동시에 업데이트될 수 있는 경우, 이 함수를 사용하여 해당 사용자 지정 속성의 값을 변경하는 동안 원자성을 보장하고 디바이스 간의 충돌을 해결합니다. 사용자 지정 속성이 디바이스 간에 공유되지 않는 경우, 대신 XblMultiplayerManagerLobbySessionSetProperties 함수를 사용하여 해당 사용자 지정 속성의 값을 변경합니다.충돌로 인해 경합 상태가 발생하면 서비스가 사용자 지정 속성 변경 요청을 거부할 수 있습니다. 요청이 거부되면 서비스는
HTTP_E_STATUS_PRECOND_FAILED를 반환합니다. 충돌이 발생하면 사용자 지정 속성 변경 필요성을 다시 평가하고 필요한 경우 이 함수를 다시 호출하여 요청을 재제출합니다. 이 함수의 결과는 이벤트 유형이
XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted로 설정된 멀티플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다.
Requirements
Header: multiplayer_manager_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.libSee also
multiplayer_manager_cXblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent