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

# PFMultiplayerJoinLobbyAsServer

> PFMultiplayerJoinLobbyAsServer 参考，用于通过 PlayFab Multiplayer C++ SDK 大厅 API 以 game_server 实体身份加入客户端拥有的 PlayFab 大厅。

以服务器身份加入客户端拥有的大厅。

## 语法

```cpp theme={null}
HRESULT PFMultiplayerJoinLobbyAsServer(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const char* connectionString,  
    const PFLobbyServerJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### 参数

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 实例的句柄。

**`server`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

加入大厅的服务器的 PlayFab 实体键。其实体类型必须为 “game\_server”。

**`connectionString`**   char\*\
*is null-terminated*

服务器用于加入大厅的连接字符串。

**`configuration`**   [PFLobbyServerJoinConfiguration\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyserverjoinconfiguration)

加入大厅时要存储的初始服务器拥有数据。

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

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

**`lobby`**   PFLobbyHandle\*\
*optional, library-allocated output*

可选的输出大厅对象，可用于在此操作完成后立即排队执行操作。

### 返回值

类型：HRESULT

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

## 备注

要使用此功能，必须在包含 PFLobby.h 之前定义 PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS。<br /><br /> 这是一个异步操作。此方法执行的完成并不一定意味着操作的完成。  <br /><br /> 成功完成后，将向标题提供一个 [PFLobbyUpdatedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange)，其 [PFLobbyUpdatedStateChange::serverUpdate](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange) 成员会被相应地填充，同时还会提供一个 [PFLobbyJoinLobbyAsServerCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange)，其中 [PFLobbyJoinLobbyAsServerCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange) 字段设置为 `S_OK`。  <br /><br /> 完成失败时，将向标题提供一个 [PFLobbyJoinLobbyAsServerCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange)，其中 [PFLobbyJoinLobbyAsServerCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange) 字段设置为失败。  <br /><br /> 此操作仅限于使用连接的客户端拥有的大厅。

## 要求

**头文件：** PFLobby.h

## 另请参阅

[PFLobby 成员](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyJoinLobbyAsServerCompletedStateChange](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md)
- [PlayFab Multiplayer C++ SDK 发行说明](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFLobbyGetLobbyId](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyid.md)
- [PFLobbyGetServerConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetserverconnectionstatus.md)
- [大厅所有权](/zh-CN/services/playfab/multiplayer/lobby/owner-requirements-and-privileges.md)