語法
參數
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。
此作業僅限於使用連線的用戶端擁有大廳。
