PFLobbyGetServerConnectionStatus

检索大厅服务器与通知服务的连接状态。

语法

HRESULT PFLobbyGetServerConnectionStatus(  
    PFLobbyHandle lobby,  
    PFLobbyServerConnectionStatus* connectionStatus  
)  

参数

lobby PFLobbyHandle

大厅的句柄。

connectionStatusPFLobbyServerConnectionStatus*
输出

服务器的输出连接状态。

返回值

类型:HRESULT

如果调用成功,则为 S_OK,否则为错误代码。 可通过 PFMultiplayerGetErrorMessage() 检索错误代码的可读形式。

备注

加入大厅时,库会建立与 PlayFab PubSub 通知服务的 WebSocket 连接。 此连接用于为库提供有关大厅的实时更新。 此方法可用于确定大厅服务器的连接状态,这对于诊断大厅服务器接收大厅相关更新的能力非常有用。

非拥有的大厅服务器只能加入客户端拥有的大厅。 如果没有服务器加入客户端拥有的大厅,此方法会返回相应的错误代码。

如果大厅服务器仍在通过调用 PFMultiplayerJoinLobbyAsServer() 异步加入大厅,那么该服务器会看到其连接状态为 PFLobbyServerConnectionStatus::NotConnected,直到连接已建立。

PFLobbyUpdatedStateChange::serverConnectionStatusUpdated 字段设置为 true 的情况下通过 PFLobbyUpdatedStateChange 向游戏显示大厅服务器连接状态的更改。

要求

标头: PFLobby.h

另请参阅

PFLobby 成员