> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerManagerGameSessionSetSynchronizedProperties

> XblMultiplayerManagerGameSessionSetSynchronizedProperties

# XblMultiplayerManagerGameSessionSetSynchronizedProperties

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

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerManagerGameSessionSetSynchronizedProperties(  
         const char* name,  
         const char* valueJson,  
         void* context  
)  
```

### Parameters

*name*   \_In\_z\_\
Type: char\*

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

*valueJson*   \_In\_z\_\
Type: char\*

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

*context*   \_In\_opt\_\
Type: void\*

선택 사항. [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)를 시작 호출과 연관시키는 애플리케이션 정의 데이터입니다.

### Return value

Type: HRESULT

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

## Remarks

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

## Requirements

**Header:** multiplayer\_manager\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost)\
[XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)


## Related topics

- [XblMultiplayerManagerGameSessionSetSynchronizedHost](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetProperties](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md)
- [XblMultiplayerManagerGameSessionPropertiesJson](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionpropertiesjson.md)
- [Multiplayer Manager API 개요](/ko/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerManagerJoinGame](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)