EVT_BACNET_UTCTIMESYNC (STRUCT)¶

TYPE EVT_BACNET_UTCTIMESYNC : STRUCT

The UTC TimeSynchronization service hook

This is the type declaration for the UTC Time Synchronization service application hook. This hook allows a BACnet application to override the default BACnet processing of a Time Synchronization service request. The hook is given all of the parameters of a service request, and is responsible for all error checking (address correctness, value correctness and so forth). A pointer to the routine is registered with the BACnet server by BACnetSetHook. A hook can be registered by the registering API routine at any time. One hook procedure is registered per service. If a hook is registered more than once for the same service, the new hook procedure replaces old one. A 0 procedure pointer can be used to deregister the hook. Since this is an unconfirmed service, no response is expected. A Time Synchronization hook must complete its service request processing only by returning its Return Value.

InOut:

Name	Type	Comment
`pCBStatus`	POINTER TO IEC_BACNET_CB_STATUS	CB-Status returned for the event. “Default” processes the standard APIs reaction, which needs no additional Callback-Signalling.
`phTransaction`	POINTER TO BYTE	This is the Transaction State Machine (TSM) handle for the current service request. It is generated by the BACnet API and is the first parameter given to the Hook- Completion functions.
`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_TIME_SYNC_INFO	A pointer to the service information data structure. The fields of this data structure include Date Time information.