PFMultiplayerCreateAndClaimServerLobby
Erstellen Sie einen neuen Wartebereich als game_server Entität.
Syntax
HRESULT PFMultiplayerCreateAndClaimServerLobby(
PFMultiplayerHandle handle,
const PFEntityKey* server,
const PFLobbyCreateConfiguration* createConfiguration,
void* asyncContext,
PFLobbyHandle* lobby
)
Parameter
handle PFMultiplayerHandle
Das Handle der PFMultiplayer-API instance.
server
PFEntityKey*
Der PlayFab-Entitätsschlüssel des Spielservers, der den Wartebereich erstellt. Der Entitätstyp muss "game_server" sein.
createConfiguration
PFLobbyCreateConfiguration*
Die anfänglichen Konfigurationsdaten, die beim Erstellen des Wartebereichs verwendet werden.
asyncContext Leere*
Optional
Ein optionaler, app-definierter Kontextwert in Zeigergröße, der verwendet werden kann, um die Änderung des Abschlusszustands diesem Aufruf zuzuordnen.
lobby PFLobbyHandle*
optional, bibliotheksseitig zugeordnete Ausgabe
Das optionale Ausgabelobbyobjekt, das für Warteschlangenvorgänge für die sofortige Ausführung dieses Vorgangs verwendet werden kann, wird abgeschlossen.
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 PFLobbyCreateAndClaimServerLobbyCompletedStateChange bereitgestellt, wobei das Feld PFLobbyCreateAndClaimServerLobbyCompletedStateChange::result auf S_OKfestgelegt ist. Nach einem fehlgeschlagenen Abschluss wird dem Titel ein PFLobbyCreateAndClaimServerLobbyCompletedStateChange bereitgestellt, wobei das Feld PFLobbyCreateAndClaimServerLobbyCompletedStateChange::result auf einen Fehler festgelegt ist.
Voraussetzungen
Header: PFLobby.h