BACnetWriteFile (FUN)

FUNCTION BACnetWriteFile : IEC_BACNET_STATUS

Sends an AtomicWriteFile request.

Write an octet string into a specified position in a specified file. The file may be accessed as records or as a stream of octets. Choice is defined by the value of File_Access_Method property of the File object. Since the present version of this API does not support default processing of this service, the destination has to include a hook procedure to process it. This routine may control APDU properties like APDU length, segmentation, and timeout for both request and in response. This routine can execute asynchronously, i.e. this routine will return to the caller before the BACnet reply comes so that the applications can keep running. In this case the response information will be received by the thread which is responsible for receiving asynchronous responses. An optional BACNET_WRITE_FILE_COMPLETE_CB routine, which is provided by the BACnet application, shall be used to process this information. If a number of asynchronous requests are sent, the responses shall be queued and identified by the transaction handles. If the application does not supply the BACNET_WRITE_FILE_COMPLETE_CB routine; then the BACnetWriteFile routine sends a request and waits for reply.

Asynchron call, which fills pResult with the call result in an asynchronus manner. As soon as pResultStatus is IEC_BACNET_STATUS.BACNET_STATUS_OK the data in pResult is valid.

InOut:

Scope	Name	Type	Comment
Return	BACnetWriteFile	IEC_BACNET_STATUS	A status indicating whether the operation worked.
Input	pSourceAddress	POINTER TO IEC_BACNET_ADDRESS	If the BACnet application has only one device constructed and installed, this can be 0. In this case the MAC address of this device will be used. Otherwise this shall be the MAC address returned on device object construction.
	pDestinationAddress	POINTER TO IEC_BACNET_ADDRESS	This is the MAC address of the device to which the request should be sent.
	pWriteInfo	POINTER TO IEC_BACNET_WRITE_FILE_INFO	A pointer to the service request information data structure. This data structure contains the objectID, File Access Type (IEC_BACNET_FILE_ACCESS_TYPE.FILE_ACCESS_STREAM or IEC_BACNET_FILE_ACCESS_TYPE.FILE_ACCESS_RECORD) and Write File Data information.
	pAPDUParams	POINTER TO IEC_BACNET_APDU_PROPERTIES	A pointer to the APDU-Properties structure which sets APDU properties for this transaction only. This does not change global defaults or settings for the application APDU Properties. This argument may be 0. In this case APDU properties are used which were specified in the device object properties of the applications device which sends the request.
	pResult	POINTER TO IEC_BACNET_WRITE_FILE_RESULT	A pointer to a buffer to hold the Result data if successful writing (datatype IEC_BACNET_WRITE_FILE_RESULT).
	pTransactionToken	POINTER TO BACnetAsyncTransactionToken	Transaction token of the asynchronous call - see BACnetAsyncTransactionToken.
	pError	POINTER TO IEC_BACNET_ERROR	A pointer to a structure to hold BACnet Error information. pError may be 0 if the application isn’t interested in detailed error information.