PartyManager::Cleanup

立即回收与所有 Party 库对象关联的所有资源。

语法

PartyError Cleanup(  
)  

参数

返回值

PartyError

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

备注

如果本地用户正在参与 PartyNetwork,则会不正常地将其删除(在远程设备看来,已丢失与此设备的网络连接),因此,最佳做法是首先对从 GetNetworks() 调用返回的所有网络调用 PartyNetwork::LeaveNetwork(),然后等待相应的 PartyLeaveNetworkCompletedStateChange,以使本地用户正常退出任何现有 PartyNetwork。

此方法是非线程安全的,不能与其他非静态 Party 库方法同时调用。 调用此方法后,所有 Party 库状态都将失效。

使用 Party 库的 Microsoft Game Core 版本的游戏必须通过 RegisterAppStateChangeNotification API 侦听应用状态通知。 当应用挂起时,游戏必须调用 PartyManager::Cleanup()。 应用恢复后,游戏必须等待 Game Core 网络堆栈准备就绪,然后通过调用 PartyManager::Initialize() 重新初始化 Party 库。

每次调用 Initialize() 都应该调用相应的 Cleanup()。

要求

标题: Party.h

另请参阅

PartyManager
PartyManager::Initialize
PartyNetwork::LeaveNetwork
PartyManager::GetNetworks