nn::nex::HostMigrationCallback Class

Syntax

class HostMigrationCallback : public nn::nex::OperationCallback

Description

Callback function to use when executing Net-Z host migration.

This is the callback function when executing Net-Z host migration. When Net-Z host migration is carried out, the new host is automatically registered with the game server.

NetZ host migration is carried out automatically, but it may behave as if two or more players are the session host at the same time. When this case occurs, NEX polls other stations and registers the winner so that the wrong host is not registered to the server.

However, if there are only two players in a session and the stations are lost because of an abnormal state by a timeout or other event, determining which is the host cannot be done with polling. If both players recognize themselves as the host (in other words, they have been orphaned), we recommend that you either end the session or register a new matchmaking session. For details, see the reference for the HostMigrationCallback::SessionHostIsOrphan function.

typedef Definitions

UpdateSessionHostCB Definition of the callback function that is called when host migration occurs.

Member Functions

HostMigrationCallback Constructor.
V ~HostMigrationCallback Destructor.
Register Registers the target of host migration.
Unregister Deletes from a host migration target.
SessionHostIsOrphan Determines whether the local host is an orphaned session host.
GetPriority Gets the priority of OperationCallback. (Inherits OperationCallback.)

Class Hierarchy

nn::nex::RootObject
  nn::nex::OperationCallback
    nn::nex::HostMigrationCallback

Revision History

2012/11/13
Revised the description to cover the situation when a station leaves because of a fault under the conditions that an isolated state was determined.
2012/06/07
Revised the text because majority polling is not conducted for host migration registration.
2011/05/09
Revised the note regarding orphaned hosts. For details, see the nn::nex::HostMigrationCallback::SessionHostIsOrphan function.
2011/01/27
Initial version.

CONFIDENTIAL