PFLobbyServerPostUpdateAsServer
Veröffentlichen Sie ein Update für einen clienteigenen Wartebereich als verknüpften Server.
Syntax
HRESULT PFLobbyServerPostUpdateAsServer(
PFLobbyHandle lobby,
const PFLobbyServerDataUpdate* serverUpdate,
void* asyncContext
)
Parameter
lobby
PFLobbyHandle
Der Griff des Wartebereichs.
serverUpdate
PFLobbyServerDataUpdate*
Ein Update, das auf den Teil der Wartedaten angewendet werden soll, der sich im Besitz des verknüpften Servers befindet.
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
Um dieses Feature verwenden zu können, müssen Sie PFMULTIPLAYER_INCLUDE_SERVER_APIS definieren, bevor Sie PFLobby.h einschließen.
Dies ist ein asynchroner Vorgang. Nach erfolgreichem Abschluss wird für den Titel ein PFLobbyServerPostUpdateAsServerCompletedStateChange bereitgestellt, wobei das Feld PFLobbyServerPostUpdateAsServerCompletedStateChange::result auf S_OK
festgelegt ist. Nach einem fehlgeschlagenen Abschluss wird dem Titel ein PFLobbyServerPostUpdateAsServerCompletedStateChange bereitgestellt, wobei das Feld PFLobbyServerPostUpdateAsServerCompletedStateChange::result auf einen Fehler festgelegt ist. Wenn das Anwenden des Updates den Status des Wartebereichs ändern würde, wird der Titel später als 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 Zustand bereitgestellt wird.
Dieser Vorgang ist auf clienteigene Lobbies beschränkt, die Verbindungen verwenden.
Voraussetzungen
Header: PFLobby.h