BACnetObjectBase.WritePropertyInstance (METH)¶

METHOD WritePropertyInstance : CmpBACnet.IEC_BACNET_STATUS

Sets the value/content of a specified BACnet-Property (ePropertyID) taking client side restrictions into account (access, priorization, range checks). In contrast to SetPropertyInstance all access, priorization and range checks are executed by this call and on return the occurred BACnet error code will be returned. The specified index should be set to -1, meaning that all elements of a List or Array in a BACnet-Property are stored. Otherwise an index counting from 1 specifies a element of a List or Array of a BACnet-Property, whereas this access method should be only used for BACnet-Property of constant array size. Moreover the IEC_BACNET_PEROPERTY_CONTENTS variable propertyContents holds the information to be written, whereas the data given in propertyContents.Buffer.pBuffer has to be in the format expected by the specified BACnet-Property-Type.

InOut:

Scope	Name	Type	Comment
Return	WritePropertyInstance	CmpBACnet.IEC_BACNET_STATUS
Input	ePropertyID	CmpBACnet.IEC_BACNET_PROPERTY_ID	The property ID of the property to write its instance data for.
	nIndex	DINT	Counting from 1. See documentation of CmpBACnet.BACnetRetrievePropertyInstance.
	priority	DINT	The priority to use when writing to the specified property value.
	propertyContents	CmpBACnet.IEC_BACNET_PROPERTY_CONTENTS	Property-Contents to be written to the specified BACnet- Property.
Output	error	CmpBACnet.IEC_BACNET_ERROR	BACnet error code.