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

IEC_BACNET_STATUS

Input

instNumber

IEC_BACNET_INST_NUMBER

The device instance number in which the object exists.

pObjectID

POINTER TO IEC_BACNET_OBJECT_ID

A pointer to the object Identifier.

ePropertyID

IEC_BACNET_PROPERTY_ID

The Property identifier of the local property.

nIndex

IEC_BACNET_ARRAY_INDEX

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

IEC_BACNET_PRIORITY_LEVEL

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.