BACnetConstructObject (FUN)ΒΆ

FUNCTION BACnetConstructObject : IEC_BACNET_STATUS

Constructs a local object using a list of property instances.

This function will construct an object in the local server database. The application has to provide a list with correctly initialized property values. In the call to ::BACnetConstructDevice the application needs to specify how many objects it needs at its maximum level.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetConstructObject

IEC_BACNET_STATUS

Input

instNumber

IEC_BACNET_INST_NUMBER

The device instance number in which the new object will be constructed.

pObjID

POINTER TO IEC_BACNET_OBJECT_ID

A pointer to the object identifier which specifies object type and instance number of the object to construct.

propList

POINTER TO IEC_BACNET_PROPERTY_INSTANCE

Points to the object description with the property list including their initial values along with additional flags determining default actions for each property. First property in the list shall be object-identifier. Values of object-identifier and object-name properties shall be unique inside of each device.

propCount

IEC_BACNET_PROPERTY_COUNT

Count of property images in the property list.

pError

POINTER TO IEC_BACNET_ERROR

Points to memory to store additional error information in case of any error. Can be NULL if user is not interested to get this information.

pnFirstFailedIdx

POINTER TO IEC_BACNET_PROPERTY_COUNT

Points to memory to store the index in the list of property instances which has failed to be stored in the objects database. Can be NULL if user is not interested to get this information.

bSupportUnsolicitedCOV

IEC_BACNET_BOOLEAN

If set to True the object will send out unconfirmed cov notifications if the object type supports the cov service.

bFunctionInStackEnabled

IEC_BACNET_BOOLEAN

If set to True the API internal actions (like intrinsic reporting, change of value reporting, logging, scheduling and other features) are active.

bHideObjectToOutside

IEC_BACNET_BOOLEAN

If set to True this object will not be listed in the device object-list and it will also not be accessable by ANY BACnet service requesting it but it will be fully operational for the application.