PFLobbyAddMember
Fügen Sie dem Wartebereich einen lokalen Benutzer als Mitglied hinzu.
Syntax
HRESULT PFLobbyAddMember(
PFLobbyHandle lobby,
const PFEntityKey* localUser,
uint32_t memberPropertyCount,
const char* const* memberPropertyKeys,
const char* const* memberPropertyValues,
void* asyncContext
)
Parameter
lobby PFLobbyHandle
Der Griff des Wartebereichs.
localUser
PFEntityKey*
Der PlayFab-Entitätsschlüssel des lokalen Benutzers, der dem Wartebereich als Mitglied hinzugefügt werden soll.
memberPropertyCount uint32_t
Eingabe im Bereich 0,PFLobbyMaxMemberPropertyCount
Die Anzahl der anfänglichen Membereigenschaften, die für diesen Benutzer festgelegt werden sollen, wenn er dem Wartebereich beitritt.
memberPropertyKeys char* const*
Eingabearray der Größe memberPropertyCount
Die Schlüssel der anfänglichen Membereigenschaften, die für diesen Benutzer festgelegt werden sollen, wenn er dem Wartebereich beitritt.
memberPropertyValues char* const*
Eingabearray der Größe memberPropertyCount
Die Werte der anfänglichen Membereigenschaften, die für diesen Benutzer festgelegt werden sollen, wenn er dem Wartebereich beitritt.
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
Dies ist ein asynchroner Vorgang. Nach erfolgreichem Abschluss wird dem Titel ein PFLobbyMemberAddedStateChange gefolgt von pfLobbyAddMemberCompletedStateChange bereitgestellt, wobei das Feld PFLobbyAddMemberCompletedStateChange::result auf S_OKfestgelegt ist. Nach einem fehlgeschlagenen Abschluss wird dem Titel ein PFLobbyAddMemberCompletedStateChange mit dem Feld PFLobbyAddMemberCompletedStateChange::result bereitgestellt, das auf ein Fehler-hresult festgelegt ist.
Diese Methode wird verwendet, um einem bereits vorhandenen Lobbyobjekt eine weitere lokale PlayFab-Entität hinzuzufügen. Da das Lobbyobjekt bereits über einen Aufruf von PFMultiplayerCreateAndJoinLobby oder PFMultiplayerJoinLobby erstellt worden sein muss, ist diese Methode in erster Linie für Szenarien mit mehreren lokalen Benutzern nützlich.
Dies ist ein asynchroner Vorgang. Der über diese Methode hinzugefügte Member wird erst dann in den von PFLobbyGetMembers zurückgegebenen Listen widergespiegelt, wenn der asynchrone Vorgang erfolgreich abgeschlossen wurde und eine PFLobbyMemberAddedStateChange Struktur von PFMultiplayerStartProcessingLobbyStateChanges bereitgestellt wird.
Voraussetzungen
Header: PFLobby.h