跳轉到主要內容
宣告既有伺服器大廳的擁有權。

語法

參數

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

傳回值

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

備註

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

這是一項非同步作業。成功完成時,遊戲會收到 PFLobbyClaimServerLobbyCompletedStateChange::result 欄位設定為 S_OK 的 PFLobbyClaimServerLobbyCompletedStateChange。 失敗完成時,遊戲會收到 PFLobbyClaimServerLobbyCompletedStateChange::result 欄位設定為失敗的 PFLobbyClaimServerLobbyCompletedStateChange。

此作業主要用於支援 game_server 實體取得擁有者已中斷連線或即將中斷連線之伺服器擁有大廳的擁有權。通常,這對想要將擁有權移轉給另一個 game_server 實體的 game_server 實體,或在發生某些導致其失去大廳控制代碼存取權的嚴重失敗 (例如當機) 後需要復原其伺服器擁有權的 game_server 實體很有用。

遊戲伺服器不得宣告另一個 game_server 實體目前已連線之大廳的擁有權。

需求

標頭: PFLobby.h

另請參閱

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