This method represents the BACnet service CreateObject. It is used to create a new instance of an object. The BACnet properties of standard objects created with this Method may be initialized in two ways: initial values may be provided as part of the CreateObject Method call or values may be written to the newly created object using OPC UA Write.

Signature

CreateObject (

[in]BACnetObjectIdentifier ObjectSpecifier

[in]0:KeyValuePair[] ListOfInitialValues

);

Argument

Description

ObjectSpecifier

Provides the information about the BACnet object type to be created or the BACnet object identifier if the object to be created. The instance information shall be undefined if only the object type is passed in. The BACnetObjectIdentifier DataType is defined in 10.2.1.

ListOfInitialValues

A list of initial values that shall be used to initialize the values of the specified properties of the newly created object.

Method Result Codes

ResultCode

Description

BadOutOfMemory

This status is returned for the BACnet error code NO_SPACE_FOR_OBJECT

BadNotSupported

This status is returned for the BACnet error code DYNAMIC_CREATION_NOT_SUPPORTED

BadTypeDefinitionInvalid

This status is returned for the BACnet error code UNSUPPORTED_OBJECT_TYPE

BadNodeIdInvalid

This status is returned for the BACnet error code OBJECT_IDENTIFIER_ALREADY_EXISTS

BadTypeMismatch

This status is returned for the BACnet error code INVALID_DATATYPE

BadOutOfRange

This status is returned for the BACnet error code VALUE_OUT_OF_RANGE

BadNodeIdInvalid

This status is returned for the BACnet error code UNKNOWN_PROPERTY

BadTypeMismatch

This status is returned for the BACnet error code CHARACTER_SET_NOT_SUPPORTED

BadNotWritable

This status is returned for the BACnet error code WRITE_ACCESS_DENIED

BadTypeMismatch

This status is returned for the BACnet error code DATATYPE_NOT_SUPPORTED