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

> 透過 PlayFab Multiplayer C++ SDK 大廳 API 以 game_server 實體身分加入用戶端擁有之 PlayFab 大廳的 PFMultiplayerJoinLobbyAsServer 參考。

以伺服器身分加入用戶端擁有的大廳。

## 語法

```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\*](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

加入大廳之伺服器的 PlayFab 實體索引鍵。其實體類型必須是 "game\_server"。

**`connectionString`**   char\*\
*以 null 結尾*

伺服器用於加入大廳的連接字串。

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

加入大廳時要儲存的初始伺服器擁有資料。

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

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

**`lobby`**   PFLobbyHandle\*\
*選用，程式庫配置的輸出*

選用的輸出大廳物件，可用於將作業排入佇列，以便在此作業完成時立即執行。

### 傳回值

類型：HRESULT

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

## 備註

若要使用此功能，您必須在包含 PFLobby.h 之前定義 PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS。 <br /><br /> 這是一項非同步作業。此方法執行完成不一定代表作業完成。   <br /><br /> 成功完成時，遊戲會收到已適當填入 [PFLobbyUpdatedStateChange::serverUpdate](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange) 成員的 [PFLobbyUpdatedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange)，以及 [PFLobbyJoinLobbyAsServerCompletedStateChange::result](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange) 欄位設定為 `S_OK` 的 [PFLobbyJoinLobbyAsServerCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange)。   <br /><br /> 失敗完成時，遊戲會收到 [PFLobbyJoinLobbyAsServerCompletedStateChange::result](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange) 欄位設定為失敗的 [PFLobbyJoinLobbyAsServerCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange)。   <br /><br /> 此作業僅限於使用連線的用戶端擁有大廳。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFLobbyJoinLobbyAsServerCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFLobbyGetLobbyId](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyid.md)
- [PFLobbyGetServerConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetserverconnectionstatus.md)
- [大廳擁有權](/zh-TW/services/playfab/multiplayer/lobby/owner-requirements-and-privileges.md)