Pular para o conteúdo principal
Publica uma atualização no lobby como jogador.

Sintaxe

Parâmetros

lobby   PFLobbyHandle O identificador do lobby. localUser   PFEntityKey* O usuário local que está publicando a atualização. lobbyUpdate   PFLobbyDataUpdate*
opcional
Uma atualização opcional a ser aplicada à parte compartilhada do lobby em nome de localUser. Se ela não for fornecida, memberUpdate precisará ser fornecido. memberUpdate   PFLobbyMemberDataUpdate*
opcional
Uma atualização opcional a ser aplicada à parte do lobby pertencente a localUser. Se esse parâmetro não for fornecido, lobbyUpdate precisará ser fornecido. asyncContext   void*
opcional
Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

Valor retornado

Tipo: HRESULT S_OK se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de PFMultiplayerGetErrorMessage().

Comentários

Esta é uma operação assíncrona. Após a conclusão bem-sucedida, o título receberá uma PFLobbyPostUpdateCompletedStateChange com o campo PFLobbyPostUpdateCompletedStateChange::result definido como S_OK. Após uma conclusão com falha, o título receberá uma PFLobbyPostUpdateCompletedStateChange com o campo PFLobbyPostUpdateCompletedStateChange::result definido como uma falha. Se a aplicação da atualização alterar o estado do lobby, o título receberá uma PFLobbyUpdatedStateChange algum tempo depois.

A conclusão bem-sucedida desta operação indica apenas que o serviço de Lobby aceitou a atualização. A visão local do título sobre o estado do lobby não refletirá essa atualização até que uma PFLobbyUpdatedStateChange seja fornecida ao título com o estado atualizado.

O lobbyUpdate contém campos que só podem ser modificados pelo proprietário do lobby. Este método retornará um erro se um desses campos for especificado e localUser não for o proprietário do lobby.

Se um lobbyUpdate e um memberUpdate forem fornecidos a este método em nome de uma única entidade, as duas atualizações acontecerão atomicamente.

Requisitos

Cabeçalho: PFLobby.h

Confira também

Membros do PFLobby
PFLobbyServerPostUpdate
Última modificação em 8 de outubro de 2026