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

# PFLobbyPostUpdate

> 使用 PlayFab Multiplayer C++ SDK 非同步大廳 API 從用戶端以玩家身分張貼大廳或成員資料更新的 PFLobbyPostUpdate 參考。

以玩家身分將更新張貼至大廳。

## 語法

```cpp theme={null}
HRESULT PFLobbyPostUpdate(  
    PFLobbyHandle lobby,  
    const PFEntityKey* localUser,  
    const PFLobbyDataUpdate* lobbyUpdate,  
    const PFLobbyMemberDataUpdate* memberUpdate,  
    void* asyncContext  
)  
```

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

**`localUser`**   [PFEntityKey\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

張貼更新的本機使用者。

**`lobbyUpdate`**   [PFLobbyDataUpdate\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydataupdate.md)\
*選用*

代表 `localUser` 套用至大廳共用部分的選用更新。如果未提供此項，則必須提供 `memberUpdate`。

**`memberUpdate`**   [PFLobbyMemberDataUpdate\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberdataupdate.md)\
*選用*

套用至 `localUser` 所擁有之大廳部分的選用更新。如果未提供此參數，則必須提供 `lobbyUpdate`。

**`asyncContext`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫建立關聯。

### 傳回值

類型：HRESULT

如果呼叫成功，則為 `S_OK`；否則為錯誤碼。可透過 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

這是一項非同步作業。成功完成時，遊戲會收到 [PFLobbyPostUpdateCompletedStateChange::result](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md) 欄位設定為 `S_OK` 的 [PFLobbyPostUpdateCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md)。 失敗完成時，遊戲會收到 [PFLobbyPostUpdateCompletedStateChange::result](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md) 欄位設定為失敗的 [PFLobbyPostUpdateCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md)。 如果套用更新會變更大廳的狀態，遊戲稍後會收到 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md)。 \
\
 此作業成功完成只表示大廳服務已接受更新。在將具有更新狀態的 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) 提供給遊戲之前，遊戲對大廳狀態的本機檢視不會反映此更新。   \
\
 `lobbyUpdate` 包含只能由大廳擁有者修改的欄位。如果指定了其中一個欄位，且 `localUser` 不是大廳的擁有者，此方法會傳回錯誤。   \
\
 如果代表單一實體同時向此方法提供 `lobbyUpdate` 和 `memberUpdate`，兩個更新會以不可分割的方式進行。

## 需求

**標頭：** PFLobby.h

## 另請參閱

[PFLobby 成員](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)\
[PFLobbyServerPostUpdate](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)


## Related topics

- [PFLobbyServerPostUpdate](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyServerPostUpdateAsServer](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdateasserver.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [非同步 Lobby 和 Matchmaking C++ SDK 作業指南](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)