Freigeben über


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_OKfestgelegt 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

Weitere Informationen

PFLobby-Member
PFLobbyPostUpdate