nn::nex::HostMigrationCallback::SessionHostIsOrphan Member Function

Syntax

qBool SessionHostIsOrphan() const;

Parameters

None.

Return Values



Value Description
true Orphaned.
false Not orphaned.

Description

Determines whether the local host is an orphaned session host.

Determines whether the local host is an orphaned session host. The P2P session can still continue even after the local host becomes orphaned, but other clients cannot join that P2P session. To avoid that problem, you need to exit the current matchmaking session and register a new matchmaking session. To do this, destroy the existing instance of HostMigrationCallback, create a new instance of it, and then register a new matchmaking session ID. If the SessionHostIsOrphan function has returned true, you cannot reuse the HostMigrationCallback instance.

The session host is determined to have been orphaned if all of the following conditions are met.

・ Promoted to a Net-Z session host
・ Other Stations have not acknowledged that the local host is the session host
・ Of the stations leaving last, at least one has an abnormal reason for withdrawal, such as by a timeout (StationLeavingOnFault)
・ It is the only Station in the session.
When running ChangeMasterStation, be sure to verify that it has not transitioned to an orphaned state. This function may be used for polling every frame.

Revision History

2012/11/13
Added a station leaving because of a fault to the conditions for determining the isolated state.
2011/05/09
Added description of how to continue with peer-to-peer session when the host becomes orphaned.
2011/01/27
Initial version.

CONFIDENTIAL