BACnetReadRange (FUN)

FUNCTION BACnetReadRange : IEC_BACNET_STATUS

Sends a ReadRange request

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetReadRange

IEC_BACNET_STATUS

Input

pSourceAddress

POINTER TO IEC_BACNET_ADDRESS

If the BACnet application has only one device constructed and installed, this can be NULL. 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.

pServiceInfo

POINTER TO IEC_BACNET_READ_RANGE_INFO

A pointer to a data structure which contains all service parameters this service provides and the application needs to process.

pAPDUParams

POINTER TO IEC_BACNET_APDU_PROPERTIES

A pointer to the structure which contains a set of APDU properties to control the timing and size of transmitted frames for this request. It temporarily overwrites the global APDU settings made in the source device from which this request is sent and which parameters would control this request if this pointer is NULL.

pTransactionToken

POINTER TO BACnetAsyncTransactionToken

Transaction token of the asynchronous call - see BACnetAsyncTransactionToken.

pResult

POINTER TO IEC_BACNET_READ_RANGE_RESULT

This parameter points to an memory location in which the service result will be stored.

pError

POINTER TO IEC_BACNET_ERROR

In case of any service execution error the error result will be stored in the structure this pointer references. This parameter may be NULL if the application isn’t interested in detailed error information.