nn::nex::DuplicatedObject::Create Member Function

Syntax

static DuplicatedObject * Create(
     qUnsignedInt32 uiTimeout = =DEFAULT_CREATE_TIMEOUT
);

static DuplicatedObject * Create(
     DOID idUserDefinedID
);

static DuplicatedObject * Create(
     DOClassID idDOClass,
     qUnsignedInt32 uiTimeout = WAIT_INFINITE_TIMEOUT
);

static DuplicatedObject * Create(
     DOClassID idDOClass,
     DOID idUserDefinedID
);

static DuplicatedObject * Create(
     const DOHandle & dohHandle
);

Overloaded Member Functions

Create ( qUnsignedInt32 ) Creates a local instance of a duplicated object.
Create ( DOID ) Creates a local instance of a duplicated object.
Create ( DOClassID, qUnsignedInt32 ) Creates a local instance of a duplicated object.
Create ( DOClassID, DOID ) Creates a local instance of a duplicated object.
Create ( const DOHandle & ) Creates a local instance of a duplicated object.

Description of Create ( qUnsignedInt32 )

This function may return NULL. If NULL is returned, immediately destroy the NetZ instance and exit the session.

Normally, a value should be returned immediately and the function should not block. However, in the rare case that a child station could not communicate with the parent station and NULL is returned prior to the completion of the duplicated object initialization after joining a session, the function blocks for the period of time specified by uiTimeout at the maximum.

You can also use this function without blocking by specifying 0 for uiTimeout.

This static function is defined for each duplicated object class created by the Data Definition Language (DDL) compiler. For example, to create an instance of the Avatar class, call the Avatar::Create function. No function named DuplicatedObject::Create is supported.

Description of Create ( DOID )

This static function is defined for each duplicated object class created by the Data Definition Language (DDL) compiler. For example, to create an Avatar class instance, call AvatarCreate(idUserDefinedID). No function named DuplicatedObject::Create is supported.

In this overloaded function, you can explicitly specify the DOID of the duplicated object to create. This value is generated by calling the IDGenerator::GenerateID function. The duplicated object handles of the ID generators for each duplicated object class can be obtained with a function called GetIDGenerator that is implemented in the source code automatically created by the DDL compiler.

Description of Create ( DOClassID, qUnsignedInt32 )

Creates a local instance of a duplicated object having the specified duplicated object class ID (DOClassID) type. Duplicated object class IDs are automatically generated by the Data Definition Language (DDL) file.
Note: These values may change if you rewrite the DDL file and rebuild the program.

Description of Create ( DOClassID, DOID )

Creates a local instance of a duplicated object having the specified duplicated object class ID (DOClassID) type. Duplicated object class IDs are automatically generated by the Data Definition Language (DDL) file.
Note: These values may change if you rewrite the DDL file and rebuild the program.

In this overloaded function, you can explicitly specify the DOID of the duplicated object to create. This value is generated by calling the IDGenerator::GenerateID function. The duplicated object handles of the ID generators for each duplicated object class can be obtained with a function called GetIDGenerator that is implemented in the source code automatically created by the DDL compiler.

Description of Create ( const DOHandle & )

Creates a local instance of a duplicated object.


CONFIDENTIAL