XblMultiplayerManagerLobbySessionSetProperties

로비 세션에 대한 사용자 지정 속성의 값을 설정합니다.

구문

HRESULT XblMultiplayerManagerLobbySessionSetProperties(  
         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 문자열로 표시되는 로비 세션의 사용자 지정 속성 값을 설정합니다. 사용자 지정 속성은 언제든지 변경할 수 있습니다. 변경 사항이 일괄 처리되고 다음 XblMultiplayerManagerDoWork를 호출할 때 서비스에 기록됩니다. 사용자 지정 속성이 디바이스 간에 공유되거나 여러 디바이스에서 동시에 업데이트될 수 있는 경우 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 함수를 사용하여 사용자 지정 속성을 변경합니다. 그렇지 않으면 이 함수를 사용하여 사용자 지정 속성을 변경할 수 있습니다.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::SessionPropertyWriteCompleted(으)로 설정된 멀티 플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티 플레이어 이벤트를 검색할 수 있습니다.

요구 사항

헤더: multiplayer_manager_c.h

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

참고 항목

multiplayer_manager_c
XblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent