Freigeben über


PFLobbyServerPostUpdate

Veröffentlichen Sie ein Update im Wartebereich als Serverbesitzer.

Syntax

HRESULT PFLobbyServerPostUpdate(  
    PFLobbyHandle lobby,  
    const PFLobbyDataUpdate* lobbyUpdate,  
    void* asyncContext  
)  

Parameter

lobby PFLobbyHandle

Der Griff des Wartebereichs.

lobbyUpdate PFLobbyDataUpdate*

Ein Update, das für den freigegebenen Teil des Wartebereichs im Namen des Serverbesitzers angewendet werden soll.

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 dem Titel ein PFLobbyServerPostUpdateCompletedStateChange mit dem Feld PFLobbyServerPostUpdateCompletedStateChange::result bereitgestellt, das auf S_OKfestgelegt ist. Nach einem fehlgeschlagenen Abschluss wird dem Titel ein PFLobbyServerPostUpdateCompletedStateChange-Objekt bereitgestellt, wobei das Feld PFLobbyServerPostUpdateCompletedStateChange::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.

Voraussetzungen

Header: PFLobby.h

Weitere Informationen

PFLobby-Member
PFLobbyPostUpdate