BACnetGetExtraServiceInfo (FUN)

FUNCTION BACnetGetExtraServiceInfo : IEC_BACNET_STATUS

Function retrieves extra information about the actual service executed.

This function will retrieve extra information about the actual execuded service request in the server API. This function will deliver the requested information only during the execution of any callbacks related to service requests received from other BACnet gear. In case this function is called OUTSIDE a callback an error status will be returned.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetGetExtraServiceInfo

IEC_BACNET_STATUS

Input

pOriginPortId

POINTER TO IEC_BACNET_BYTE

This pointer which may be NULL, will contain the port ID of the datalink over which this service request has been received.

pServiceCode

POINTER TO IEC_BACNET_SERVICE_EXECCODE

This pointer which may be NULL, will contain the service code of the service in execution.

pNetPriority

POINTER TO IEC_BACNET_BYTE

This pointer which may be NULL, will contain the network priority the received packed had.

pInvokeId

POINTER TO IEC_BACNET_BYTE

This pointer which may be NULL, will contain the invoke-id of the service request.

pSourceAddr

POINTER TO IEC_BACNET_ADDRESS

This pointer which may be NULL, will contain the source address of the requestor. This can be the origin of the request (source network informaion out of the NPDU).

pDestAddr

POINTER TO IEC_BACNET_ADDRESS

This pointer which may be NULL, will contain the destination address of the request.

pOriginAddr

POINTER TO IEC_BACNET_ADDRESS

This pointer which may be NULL, will contain the originating source address of the request. This is the source address from which this request has been sent. So in case of any BACnet routers involved this could be the routers address and NOT the source address of the requestor.

pnLengthApdu

POINTER TO IEC_BACNET_UINT

This pointer which may be NULL, will contain the .

ppFrameApdu

POINTER TO POINTER TO IEC_BACNET_BYTE

This pointer which may be NULL, will contain the .