BACnetRegisterClientCommunicationStateCallback (FUN)

FUNCTION BACnetRegisterClientCommunicationStateCallback : IEC_BACNET_STATUS

Registers the user application callback for communication changes.

This function gives a user application the ability to get notified if an connection to one of the registered devices couldn’t or could be established. It is called in every case were the connection state to an BACnet remote device changes.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetRegisterClientCommunicationStateCallback

IEC_BACNET_STATUS

Input

hCustomer

IEC_BACNET_HANDLE

An handle to an created advanced BACnet client customer created by ::BACnetOpenClientCustomer.

pICallback

CmpEventMgr.ICmpEventCallback

Pointer to the event-callback interface. Event-callback argument type is EVT_BACNET_CLIENT_STATUS. Purpose documented in BACstack: A pointer to the user application function which gets called on changes in communication to the device. To unregister from notifications a NULL pointer shall be used here.

pUserArg

POINTER TO IEC_BACNET_BYTE

A pointer to data from the user application which is transparent for the API. This pointer will not be modified by the BACnet API. This may be NULL.