BACnetCreateObjectErrorCbCompletion (FUN)

FUNCTION BACnetCreateObjectErrorCbCompletion : IEC_BACNET_STATUS

Sends a CreateObject error

Completes a Create-Object hook by generating a BACnet-Error reply. The BACnetSrvcErrorCbCompletion routine should not be used for these services, since they must include the sequence number of the offending Property value list element in the reply. All confirmed service hooks must call a response or error completion routine to perform transaction clean-up and to send a response over the BACnet. The hook completion routine frees all resources it uses.

InOut:

Scope

Name

Type

Comment

Return

BACnetCreateObjectErrorCbCompletion

IEC_BACNET_STATUS

A status indicating if the operation worked.

Input

phTransaction

POINTER TO BYTE

Transaction State Machine (TSM) handle for the request to be processed by the hook.

errClass

IEC_BACNET_ERROR_CLASS

Variable to hold BACnet Error Class information.

errCode

IEC_BACNET_ERROR_CODE

Variable to hold BACnet Error Code information.

firstFailed

IEC_BACNET_UNSIGNED

The sequence number of the first element in the Property Value list which caused an error in the Create-Object service. If the reasons other than property initialization caused an error, this argument will have a value of zero.