Sintaxis
Parámetros
handle PFMultiplayerHandle
El identificador de la instancia de la API PFMultiplayer.
server PFEntityKey*
La clave de entidad de PlayFab del servidor de juego que reclama el lobby. Su tipo de entidad debe ser “game_server”.
lobbyId char*termina en null El identificador del lobby que se va a reclamar.
asyncContext void*opcional Un valor de contexto opcional, definido por la aplicación y del tamaño de un puntero, que se puede usar para asociar el cambio de estado de finalización con esta llamada.
lobby PFLobbyHandle*opcional, salida asignada por la biblioteca El objeto de lobby de salida opcional, que se puede usar para poner en cola operaciones para su ejecución inmediata cuando se complete esta operación.
Valor devuelto
Tipo: HRESULTS_OK si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante PFMultiplayerGetErrorMessage().
Comentarios
Para usar esta característica, debe definir PFMULTIPLAYER_INCLUDE_SERVER_APIS antes de incluir PFLobby.h.Esta es una operación asincrónica. Cuando se completa correctamente, el título recibirá un PFLobbyClaimServerLobbyCompletedStateChange con el campo PFLobbyClaimServerLobbyCompletedStateChange::result establecido en
S_OK. Si se completa con errores, el título recibirá un PFLobbyClaimServerLobbyCompletedStateChange con el campo PFLobbyClaimServerLobbyCompletedStateChange::result establecido en un error. Esta operación está pensada principalmente para permitir que las entidades game_server tomen la propiedad de lobbies propiedad de un servidor cuyos propietarios se han desconectado o se desconectarán. Normalmente, esto interesa a las entidades game_server que desean migrar la propiedad a otra entidad game_server o a las entidades game_server que necesitan recuperar la propiedad de sus propios servidores después de algún error grave que les haga perder el acceso al identificador del lobby, como un bloqueo.
Un servidor de juego no puede reclamar la propiedad de un lobby al que otra entidad game_server esté conectada actualmente.