EVT_BACNET_ADD_ELEMENT (STRUCT)¶

TYPE EVT_BACNET_ADD_ELEMENT : STRUCT

The AddListElement service hook.

An Add List Element hook must complete its service request processing by using one of the transaction completion API routines: ::BACnetSrvcResponseCbCompletion, ::BACnetSrvcAbortCbCompletion, ::BACnetSrvcErrorCbCompletion, ::BACnetSrvcIgnoreCbCompletion, or ::BACnetSrvcRejectCbCompletion. Hooks can access the local Properties maintained in the API database by using the ::BACnetStorePropertyInstance / ::BACnetRetrievePropertyInstance routines. A hook can choose not to override the default API processing of a service request by returning the value ::CB_STATUS_DEFAULT.

Return: IEC_BACNET_STATUS

InOut:

Name	Type	Comment
pCBStatus	POINTER TO IEC_BACNET_CB_STATUS	CB-Status returned for the event. CB_STATUS_DEFAULT: The hook did not handle the requests - the BACnet API stack default actions should handle the request. CB_STATUS_OK: The hook completed successfully.
phTransaction	POINTER TO BYTE	This handle identifies the current request in the API’s internal transaction state machine.
sourceAddress	POINTER TO IEC_BACNET_ADDRESS	This is the MAC address of the BACnet addressed device from which the request has been sent.
destinationAddress	POINTER TO IEC_BACNET_ADDRESS	This is the MAC address of the device constructed by the application which has received the request.
pServiceInfo	POINTER TO IEC_BACNET_CHANGE_LIST_INFO	A pointer to a data structure which contains all service parameters this service provides and the application needs to process.