PFMultiplayerJoinLobby
Treten Sie einer Lobby als lokale PlayFab-Entität bei.
Syntax
HRESULT PFMultiplayerJoinLobby(
PFMultiplayerHandle handle,
const PFEntityKey* newMember,
const char* connectionString,
const PFLobbyJoinConfiguration* configuration,
void* asyncContext,
PFLobbyHandle* lobby
)
Parameter
handle PFMultiplayerHandle
Das Handle der PFMultiplayer-API instance.
newMember
PFEntityKey*
Die lokale Entität, die dem Wartebereich beitritt.
connectionString Char*
ist NULL-terminiert.
Die Verbindungszeichenfolge von der Entität verwendet, um dem Wartebereich beizutreten.
configuration
PFLobbyJoinConfiguration*
Die anfänglichen Konfigurationsdaten, die beim Beitritt zum Wartebereich 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
Dies ist ein asynchroner Vorgang. Nach erfolgreichem Abschluss erhält der Titel eine PFLobbyMemberAddedStateChange gefolgt von pfLobbyUpdatedStateChange und PFLobbyJoinLobbyCompletedStateChange , wobei das Feld PFLobbyJoinLobbyCompletedStateChange::result auf S_OKfestgelegt ist. Nach einem fehlgeschlagenen Abschluss wird dem Titel ein PFLobbyJoinLobbyCompletedStateChange-Objekt bereitgestellt, wobei das Feld PFLobbyJoinLobbyCompletedStateChange::result auf einen Fehler festgelegt ist.
Voraussetzungen
Header: PFLobby.h