BACnetWritePropertyInstance
(FUN)
FUNCTION BACnetWritePropertyInstance : IEC_BACNET_STATUS
Updates an object property with new data value.
This function works like ::BACnetStorePropertyInstance does but it emulates the access like an external WriteProperty access from an external BACnet client. All access, priorization and range checks are executed by this call and on return the occurred BACnet error code will be returned.
Return: IEC_BACNET_STATUS
- InOut:
Scope
Name
Type
Comment
Return
BACnetWritePropertyInstance
Input
instNumber
The device instance number in which the object exists.
pObjectID
POINTER TO IEC_BACNET_OBJECT_ID
A pointer to the object Identifier.
ePropertyID
The Property identifier of the local property.
nIndex
The optional index information of an array item from a property if this property contains an array. BACnet array indexes start counting at 1.
priority
The priority level for the Write-Property request, in case the Property is a commandable Property. If not the priority level BACNET_VOID_PRI should be used.
pValue
POINTER TO IEC_BACNET_PROPERTY_CONTENTS
Pointer to a property pontents containing a buffer which contains the value.
pValueSrc
POINTER TO IEC_BACNET_AUDIT_VALUE_SOURCE
A pointer to a data structure which contains the value source information for generating an logged and/or reported audit notification for this initiated request. This is an optional parameter and may be set to NULL. In this case a default value is used to fill the audit log entry.
pError
POINTER TO IEC_BACNET_ERROR
A pointer to store the returned BACnet error code.