PFLobbyPostUpdate
Posten Sie ein Update im Wartebereich als Spieler.
Syntax
HRESULT PFLobbyPostUpdate(
PFLobbyHandle lobby,
const PFEntityKey* localUser,
const PFLobbyDataUpdate* lobbyUpdate,
const PFLobbyMemberDataUpdate* memberUpdate,
void* asyncContext
)
Parameter
lobby PFLobbyHandle
Der Griff des Wartebereichs.
localUser
PFEntityKey*
Der lokale Benutzer, der das Update veröffentlicht.
lobbyUpdate
PFLobbyDataUpdate*
Optional
Ein optionales Update, das auf den freigegebenen Teil des Wartebereichs im Namen von localUserangewendet werden soll. Wenn dies nicht angegeben ist, memberUpdate muss bereitgestellt werden.
memberUpdate
PFLobbyMemberDataUpdate*
Optional
Ein optionales Update, das auf den Teil des Wartebereichs angewendet werden soll, der sich im Besitz von befindet localUser. Wenn dieser Parameter nicht angegeben wird, lobbyUpdate muss angegeben werden.
asyncContext Leere*
Optional
Ein optionaler, app-definierter Kontextwert in Zeigergröße, der verwendet werden kann, um die Änderung des Abschlusszustands diesem Aufruf zuzuordnen.
Rückgabewert
Typ: HRESULT
S_OK , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über PFMultiplayerGetErrorMessage() abgerufen werden.
Hinweise
Dies ist ein asynchroner Vorgang. Nach erfolgreichem Abschluss wird dem Titel ein PFLobbyPostUpdateCompletedStateChange mit dem Feld PFLobbyPostUpdateCompletedStateChange::result bereitgestellt, das auf S_OKfestgelegt ist. Nach einem fehlgeschlagenen Abschluss wird dem Titel ein PFLobbyPostUpdateCompletedStateChange bereitgestellt, wobei das Feld PFLobbyPostUpdateCompletedStateChange::result auf einen Fehler festgelegt ist. Wenn das Anwenden des Updates den Status des Wartebereichs ändern würde, wird dem Titel später ein PFLobbyUpdatedStateChange bereitgestellt.
Dieser Vorgang, der erfolgreich abgeschlossen wurde, gibt nur an, dass der Lobbydienst das Update akzeptiert hat. Die lokale Ansicht des Titels des Lobbyzustands spiegelt dieses Update erst wieder, wenn dem Titel ein PFLobbyUpdatedStateChange mit dem aktualisierten Status bereitgestellt wird.
Enthält lobbyUpdate Felder, die nur vom Besitzer des Wartebereichs geändert werden können. Diese Methode gibt einen Fehler zurück, wenn eines dieser Felder angegeben ist und localUser nicht der Besitzer des Wartebereichs ist.
Wenn sowohl als lobbyUpdatememberUpdate auch für diese Methode im Namen einer einzelnen Entität bereitgestellt werden, erfolgen beide Aktualisierungen atomar.
Voraussetzungen
Header: PFLobby.h