PFMultiplayerStartListeningForLobbyInvites
Aktiviert den Wartelistener für Die Lobby-Einladung für eine bestimmte Entität.
Syntax
HRESULT PFMultiplayerStartListeningForLobbyInvites(
PFMultiplayerHandle handle,
const PFEntityKey* listeningEntity
)
Parameter
handle
PFMultiplayerHandle
Das Handle der PFMultiplayer-API instance.
listeningEntity
PFEntityKey*
Die Entität, die auf Einladungen lauscht.
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
Dieser Vorgang beginnt synchron mit dem Lauschen auf Einladungen im Namen der bereitgestellten Entität. Wenn Einladungen empfangen werden, werden sie über PFLobbyInviteReceivedStateChange-Strukturen bereitgestellt. Wenn sich die status des Einladungslisteners ändert, werden Benachrichtigungen über PFLobbyInviteListenerStatusChangedStateChange-Strukturen bereitgestellt.
Nur Einladungen, die nach dem Starten des Listeners gesendet wurden, werden auf diesem Client empfangen. Einladungen, die gesendet werden, während dieser Listener nicht aktiv ist, werden nicht in die Warteschlange eingereiht.
Das Abhören von Einladungen ist standardmäßig für alle Entitäten deaktiviert. Diese Methode sollte für jede lokale Entität aufgerufen werden, für die der Titel Lobby-Einladungen empfangen möchte.
Lobbyeinladungen und dieser Einladungslistener sind nicht mit plattformbezogenen Einladungsmechanismen verbunden und davon nicht betroffen.
Diese Methode kann nur aufgerufen werden, wenn der Einladungslistener für den Wartebereich nicht bereits für die angegebene Entität aktiviert ist.
Voraussetzungen
Header: PFLobby.h