E57 Foundation API v1.1.312  Aug. 10, 2011
StructureNode ( ImageFile  destImageFile)

Create an empty StructureNode.

Parameters:
[in]destImageFileThe ImageFile where the new node will eventually be stored.

A StructureNode is a container for collections of named E57 nodes. The destImageFile indicates which ImageFile the StructureNode will eventually be attached to. A node is attached to an ImageFile by adding it underneath the predefined root of the ImageFile (gotten from ImageFile::root). It is not an error to fail to attach the StructureNode to the destImageFile. It is an error to attempt to attach the StructureNode to a different ImageFile.

Precondition:
The destImageFile must be open (i.e. destImageFile.isOpen() must be true).
The destImageFile must have been opened in write mode (i.e. destImageFile.isWritable() must be true).
Returns:
A smart StructureNode handle referencing the underlying object.
Exceptions:
E57_ERROR_IMAGEFILE_NOT_OPEN
E57_ERROR_INTERNALAll objects in undocumented state
See also:
StructureCreate.cpp example, NodeFunctions.cpp example, Node
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines