BACnetRegisterClientEventNotification (FUN)

FUNCTION BACnetRegisterClientEventNotification : IEC_BACNET_STATUS

Registers an device notification class reference for event and alarm acquisation.

This function enables the user appliaction to subscribe to an event and alarm source very easy. This function will do most of the work, normally a client application has to manage, just in one call. It checks periodical for the presence and online state for devices and checks for integrity of the alarms and event acquired from other devices.

Return: IEC_BACNET_STATUS

InOut:

Scope	Name	Type	Comment
Return	BACnetRegisterClientEventNotification	IEC_BACNET_STATUS
Input	hCustomer	IEC_BACNET_HANDLE	An handle to an created advanced BACnet client customer created by ::BACnetOpenClientCustomer.
	devId	IEC_BACNET_INST_NUMBER	The device instance number from the remote or local device from which the events or alarms shall be acquired.
	notifClass	IEC_BACNET_INST_NUMBER	The notification class object instance number from the remote or local device from which the events or alarms shall be acquired.
	pValidTransitions	POINTER TO IEC_BACNET_BIT_STRING	A pointer to an bit string structure which contians the bits for the transitions on which a notification shall be sent. More information can be found under ::BACNET_DESTINATION
	pValidDays	POINTER TO IEC_BACNET_BIT_STRING	A pointer to an bit string structure which contians the bits for the weekdays on which a notification shall be sent. More information can be found under ::BACNET_DESTINATION
	pFromTime	POINTER TO IEC_BACNET_TIME	A pointer to a time structure which contains the start time at which notifications shall be sent. More information can be found under ::BACNET_DESTINATION
	pToTime	POINTER TO IEC_BACNET_TIME	A pointer to a time structure which contains the end time at which notifications shall NOT be sent anymore. More information can be found under ::BACNET_DESTINATION
	nSubscribeMode	IEC_BACNET_CLIENT_SUBSCRIBE_MODE	This defines how the data is acquired.
	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. The pointer is linked with the registrated notification class and will be returned in the callback on event notifications from this notificaion class.