跳轉到主要內容
以伺服器身分加入用戶端擁有的大廳。

語法

參數

handle   PFMultiplayerHandle PFMultiplayer API 執行個體的控制代碼。 server   PFEntityKey* 加入大廳之伺服器的 PlayFab 實體索引鍵。其實體類型必須是 “game_server”。 connectionString   char*
以 null 結尾
伺服器用於加入大廳的連接字串。 configuration   PFLobbyServerJoinConfiguration* 加入大廳時要儲存的初始伺服器擁有資料。 asyncContext   void*
選用
選用的應用程式定義指標大小內容值,可用來將完成狀態變更與此呼叫建立關聯。 lobby   PFLobbyHandle*
選用,程式庫配置的輸出
選用的輸出大廳物件,可用於將作業排入佇列,以便在此作業完成時立即執行。

傳回值

類型:HRESULT 如果呼叫成功,則為 S_OK;否則為錯誤碼。可透過 PFMultiplayerGetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

若要使用此功能,您必須在包含 PFLobby.h 之前定義 PFMULTIPLAYER_INCLUDE_SERVER_APIS。

這是一項非同步作業。此方法執行完成不一定代表作業完成。

成功完成時,遊戲會收到已適當填入 PFLobbyUpdatedStateChange::serverUpdate 成員的 PFLobbyUpdatedStateChange,以及 PFLobbyJoinLobbyAsServerCompletedStateChange::result 欄位設定為 S_OK 的 PFLobbyJoinLobbyAsServerCompletedStateChange。

失敗完成時,遊戲會收到 PFLobbyJoinLobbyAsServerCompletedStateChange::result 欄位設定為失敗的 PFLobbyJoinLobbyAsServerCompletedStateChange。

此作業僅限於使用連線的用戶端擁有大廳。

需求

標頭: PFLobby.h

另請參閱

PFLobby 成員
最後修改於 2026年10月8日