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

> PFLobbyPostUpdate 参考，用于通过 PlayFab Multiplayer C++ SDK 异步大厅 API 从客户端以玩家身份发布大厅或成员数据更新。

以玩家身份向大厅发布更新。

## 语法

```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-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

发布更新的本地用户。

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

代表 `localUser` 应用到大厅共享部分的可选更新。如果未提供，则必须提供 `memberUpdate`。

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

应用于 `localUser` 拥有的大厅部分的可选更新。如果未提供此参数，则必须提供 `lobbyUpdate`。

**`asyncContext`**   void\*\
*optional*

一个可选的、应用定义的、指针大小的上下文值，可用于将完成状态更改与此调用相关联。

### 返回值

类型：HRESULT

如果调用成功，则为 `S_OK`；否则为错误代码。可通过 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 检索错误代码的可读形式。

## 备注

这是一个异步操作。成功完成后，将向标题提供一个 [PFLobbyPostUpdateCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md)，其中 [PFLobbyPostUpdateCompletedStateChange::result](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md) 字段设置为 `S_OK`。完成失败时，将向标题提供一个 [PFLobbyPostUpdateCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md)，其中 [PFLobbyPostUpdateCompletedStateChange::result](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbypostupdatecompletedstatechange.md) 字段设置为失败。如果应用更新会改变大厅的状态，则将在稍后向标题提供一个 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md)。\
\
 此操作成功完成仅表示大厅服务已接受更新。在向标题提供包含更新状态的 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) 之前，标题的本地大厅状态视图不会反映此更新。  \
\
 `lobbyUpdate` 包含只能由大厅所有者修改的字段。如果指定了其中一个字段并且 `localUser` 不是大厅的所有者，则此方法将返回错误。  \
\
 如果为单个实体同时向此方法提供了 `lobbyUpdate` 和 `memberUpdate`，则这两个更新将以原子方式发生。

## 要求

**头文件：** PFLobby.h

## 另请参阅

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


## Related topics

- [PFLobbyServerPostUpdate](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyServerPostUpdateAsServer](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdateasserver.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PlayFab Multiplayer C++ SDK 发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [异步 Lobby 和 Matchmaking C++ SDK 操作指南](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)