nn::nex::NetZ Class

Syntax

class NetZ

Description

Encapsulates NetZ run-time features.

You must generate an instance of this class to use NetZ. Destroying this instance shuts down the NetZ features.

If you use the user DO feature (a .ddl file must be created), set the InitDOClasses function that is generated by the DDL compiler by using the NetZ::SetDOClassInitializationCallback function. No special action is required if you do not use the user DO feature. If you use the host migration extension feature, you must set the InitDOClasses function even if you do not use the user DO feature.

Because NetZ instances store local session objects, you need to recreate the NetZ instance for every session. Note that even when the Session::CreateSession and Session::JoinSession processes have failed, you still need to recreate the NetZ instance to join a session again.

Member Functions

NetZ Only one instance of the NetZ class is allowed to exist at any one time.
V ~NetZ When a NetZ instance is destroyed, all NetZ-related instances are shut down.
V Terminate Terminates the P2P session without destroying the objects.
V IsValid Returns whether a NetZ instance is normal.
V GetFatalError Gets fatal errors that occur within a NetZ instance.
V SetTerminateImmediately Sets the NetZ::Terminate termination mode.
V GetTerminateImmediately Gets the NetZ::Terminate termination mode.
S GetInstance Returns a pointer to a NetZ instance.
S SetNetworkTopology Defines the network topology type established by NetZ.
S SetDOClassInitializationCallback Registers a function to initialize the DO class.

Revision History

2012/08/06
Fixed the function reference because there was an error about when the NetZ::SetDOClassInitializationCallback function should be used.
2011/09/14
Added statement that nn::nex::InitDOClasses must be defined in the application if user-duplicated objects are not being used.
2011/05/24
Initial version.

CONFIDENTIAL