> ## 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.

# XblMultiplayerManagerLobbySessionSetProperties

> XblMultiplayerManagerLobbySessionSetProperties

# XblMultiplayerManagerLobbySessionSetProperties

設定大廳工作階段之自訂屬性的值。

## 語法

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

### 參數

*name*   \_In\_z\_\
類型：char\*

要設定的自訂屬性名稱。

*valueJson*   \_In\_z\_\
類型：char\*

要指派給屬性的值，以 JSON 字串表示。

*context*   \_In\_opt\_\
類型：void\*

選擇性。應用程式定義的資料，用來將 [XblMultiplayerEvent](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 與起始呼叫建立關聯。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

此函式會設定大廳工作階段之自訂屬性的值，以 JSON 字串表示。自訂屬性可以隨時變更。變更會分批處理，並在呼叫 [XblMultiplayerManagerDoWork](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 時寫入服務。如果自訂屬性在裝置之間共用，或可能同時由多個裝置更新，請使用 [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties) 函式來變更自訂屬性。否則，您可以使用此函式來變更自訂屬性。<br />此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::SessionPropertyWriteCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 來擷取多人遊戲事件。

## 需求

**標頭：** multiplayer\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[multiplayer\_manager\_c](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerLobbySessionSetSynchronizedHost](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost)\
[XblMultiplayerEvent](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)


## Related topics

- [XblMultiplayerManagerLobbySessionSetProperties](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetproperties.md)
- [XblMultiplayerManagerLobbySessionPropertiesJson](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionpropertiesjson.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md)