nn::nex::NetZ::SetTerminateImmediately Member Function

Syntax

virtual void SetTerminateImmediately(
     qBool immediately
);

Parameters

Name Description
in immediately Specify TRUE to set forcible-termination mode. Specify FALSE to set normal-termination mode.

Return Values

None.

Description

Sets the NetZ::Terminate termination mode.

When the host transfers the host rights to another station, or when the master duplicated object is transferred to another station, the NetZ::Terminate function may take up to 5 seconds to run.

Changing the termination mode to forcible-termination can reduce this time to approximately 1 second. However, because a standard disconnection network from the network is not performed, the local station sometimes appears to be disconnected from the network (from the perspective of other peers) because of a keep-alive timeout. Refrain from this technique during a standard finalization sequence.

The forcible-termination mode is set automatically in the following situations.
・ When the host calls the Session::GameOver function and ends the entire P2P session ・ When the host station calls the Session::GameOver function and then another station calls the Session::CheckGameIsOver function and TRUE is returned ・ When the Session::DestroySession function is called because the local station has obviously been disconnected from the network, or there are no stations other than the local station

The default termination mode is normal termination. This setting is applied to each NetZ instance.

See Also

Core::SetTerminateImmediately
Session::GameOver
Session::DestroySession

Revision History

2012/08/02
Added a note about the mode that is automatically set after the Session::GameOver or Session::DestroySession function is called.
2012/07/12
Initial version.

CONFIDENTIAL