nn::nex::Core::SetTerminateImmediately Member Function

Syntax

void SetTerminateImmediately(
     qBool bTerminate
);

Parameters

Name Description
in bTerminate Specify true to set terminate-immediately mode. Specify false to return to a normal mode.

Return Values

None.

Description

Sets the mode to terminate-immediately mode.

Depending on the internal library state and the network state, the NgsFacade::Terminate function and NgsFacade destructor sometimes block for a long time when finalizing NEX. You can reduce the processing time for these functions by setting them to forced termination mode. All processes for which the NetZ::SetTerminateImmediately function is set to true terminate more quickly. Because a standard disconnection 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. Functions that communicate with the server also fail. Forced termination mode is automatically set when disconnecting from the network with the AC library.

This operation can be performed by calling the nn::nex::Core::GetInstance function and then the SetTerminateImmediately function.

This function can be used to destroy an entire NEX instance when the system is shutting down or going to sleep, or when it is not connected to a network. To speed up the termination of NetZ only, use the NetZ::SetTerminateImmediately function.

The default termination mode is normal termination. This setting is maintained in each Core instance. Normal termination mode is set when logging in to the game server.

When the Session::JoinSession and Session::CreateSession functions are called while this is set to true and forced termination mode is not set automatically when the AC library disconnects from the network, NEX is forcibly terminated on an assert check and fails.

See Also

NetZ::SetTerminateImmediately

Revision History

2014/04/08
Added information about automatically setting forced termination mode when disconnecting from the network with the AC library. Added information about automatically setting normal termination mode when logging in to the game server.
2012/09/28
Added that standard disconnection from the network is not performed and that APIs that communicate with the server fail.
2012/07/13
Changed this function from a static function to a member function. Added that this function also affects the NetZ::Terminate function.
2011/01/27
Initial version.

CONFIDENTIAL