BACnetGetDeviceAddressBindingList (FUN)

FUNCTION BACnetGetDeviceAddressBindingList : IEC_BACNET_STATUS

Retrieves the entire array or one item of the array of ‘dynamic’ bound addresses.

This function may be used by an application to retrieve the complete or part of the array of the address bindings. Unresolved addresses will also be returned in the result. They will have an global broadcast address.

InOut:

Scope

Name

Type

Comment

Return

BACnetGetDeviceAddressBindingList

IEC_BACNET_STATUS

A status indicating whether the operation worked.

Input

pContents

POINTER TO IEC_BACNET_PROPERTY_CONTENTS

A pointer to the property contents structure in which the list is stored. The application may initialize the buffer with 0 pointer and 0 size. In this case the API will allocate the neccessary buffer and the application has to release with a call to BACnetFreeStackAllocatedMemory if the buffer is no longer needed.*)

nIndex

DINT

Specifies which part of the array shall be retrieved. BACNET_ENTIRE_ARRAY (-1) will return all items in the array. “BACNET_ARRAY_COUNT (0)” will return the buffer filled with an unsigned showing number of entries in the array.