BACnetStack_SetObjectTypeCreatable
bool BACnetStack_SetObjectTypeCreatable( const uint32_t deviceInstance, const uint16_t objectType, const bool creatable);Allows objects of the specified object type to be created using the BACnet Create Object service.
Note1: Device objects cannot be created using the Create Object service Note2: This function is only useful if the Create Object service is being supported
SIDE EFFECT: creatable=true ALSO marks the object type as supported, so it appears in the device’s Protocol_Object_Types_Supported. This is one-directional - creatable=false does NOT un-mark it, and the type stays advertised as supported.
BACnet reference: ANSI/ASHRAE 135-2024 clause 15.3 (CreateObject Service).
Parameters
Section titled “Parameters”| Parameter | Direction | Description |
|---|---|---|
deviceInstance |
in | The instance of the device to allow the object to be created. The device must already exist. |
objectType |
in | The object type of the objects that can be created. See CASBACnetStack::BACnetObjectType for more info. A standard type (below MAX_PROTOCOL_OBJECT_TYPES_SUPPORTED, 65 at protocol revision 24; the constant varies by revision) or a proprietary type (128 to 1023). REJECTED: the Device object type, a value in neither range, and - when creatable is true - a standard type this build does not model. |
creatable |
in | True to make objects creatable, false to make objects not creatable. Recommended value: true |
Returns
Section titled “Returns”True if successful. False if the device does not exist, objectType is rejected as above, or the stack was built without STACK_OPTION_DM_OCD_OBJECT_CREATION_AND_DELETION.
Topic: Objects and properties. Declared in CASBACnetStackDLL.h.