Syntaxe
Paramètres
lobby PFLobbyHandle
Handle du lobby.
localUser PFEntityKey*
Utilisateur local qui publie la mise à jour.
lobbyUpdate PFLobbyDataUpdate*facultatif Mise à jour facultative à appliquer à la partie partagée du lobby pour le compte de
localUser. Si elle n’est pas fournie, memberUpdate doit être fourni.
memberUpdate PFLobbyMemberDataUpdate*facultatif Mise à jour facultative à appliquer à la partie du lobby détenue par
localUser. Si ce paramètre n’est pas fourni, lobbyUpdate doit être fourni.
asyncContext void*facultatif Valeur de contexte facultative, définie par l’application et de la taille d’un pointeur, qui peut être utilisée pour associer le changement d’état d’achèvement à cet appel.
Valeur renvoyée
Type : HRESULTS_OK si l’appel a réussi, ou un code d’erreur dans le cas contraire. La forme lisible du code d’erreur peut être récupérée via PFMultiplayerGetErrorMessage().
Remarques
Il s’agit d’une opération asynchrone. En cas de réussite, le titre reçoit un PFLobbyPostUpdateCompletedStateChange dont le champ PFLobbyPostUpdateCompletedStateChange::result est défini surS_OK. En cas d’échec, le titre reçoit un PFLobbyPostUpdateCompletedStateChange dont le champ PFLobbyPostUpdateCompletedStateChange::result est défini sur une valeur d’échec. Si l’application de la mise à jour modifie l’état du lobby, le titre reçoit ultérieurement un PFLobbyUpdatedStateChange. La réussite de cette opération indique uniquement que le service Lobby a accepté la mise à jour. La vue locale de l’état du lobby dans le titre ne reflète cette mise à jour qu’une fois qu’un PFLobbyUpdatedStateChange a été fourni au titre avec l’état mis à jour.
Le
lobbyUpdate contient des champs qui ne peuvent être modifiés que par le propriétaire du lobby. Cette méthode renvoie une erreur si l’un de ces champs est spécifié et que localUser n’est pas le propriétaire du lobby. Si un
lobbyUpdate et un memberUpdate sont tous deux fournis à cette méthode pour le compte d’une même entité, les deux mises à jour sont appliquées de manière atomique.
Configuration requise
En-tête : PFLobby.hVoir aussi
Membres de PFLobbyPFLobbyServerPostUpdate