PartyManager::Cleanup

Gibt sofort alle Ressourcen zurück, die allen Parteibibliotheksobjekten zugeordnet sind.

Syntax

PartyError Cleanup(  
)  

Parameter

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über GetErrorMessage() abgerufen werden.

Hinweise

Wenn lokale Benutzer an einem PartyNetwork teilgenommen haben, werden sie nicht ordnungsgemäß entfernt (auf Remotegeräten scheint es, als ob die Netzwerkkonnektivität mit diesem Gerät verloren gegangen wäre). Daher besteht die bewährte Methode darin, PartyNetwork::LeaveNetwork() zuerst in allen Netzwerken aufzurufen, die von einem Aufruf an GetNetworks() zurückgegeben wurden, und warten, bis die entsprechenden PartyLeaveNetworkCompletedStateChange-Benutzer alle vorhandenen PartyNetworks ordnungsgemäß beenden.

Diese Methode ist nicht threadsicher und kann nicht gleichzeitig mit anderen nicht statischen Partybibliotheksmethoden aufgerufen werden. Nach dem Aufrufen dieser Methode wird der gesamte Status der Parteibibliothek ungültig.

Titel, die die Microsoft Game Core-Version der Parteibibliothek verwenden, müssen über die RegisterAppStateChangeNotification-API auf App-Statusbenachrichtigungen lauschen. Wenn die App angehalten wird, muss der Titel PartyManager::Cleanup() aufrufen. Wenn die App fortgesetzt wird, muss der Titel warten, bis der Game Core-Netzwerkstapel bereit ist, und dann die Party-Bibliothek durch Aufrufen von PartyManager::Initialize() erneut initialisieren.

Jeder Aufruf von Initialize() sollte über einen entsprechenden Cleanup()-Aufruf verfügen.

Anforderungen

Kopfball: Party.h

Weitere Informationen

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