BACnetRestoreBACnetDevice (FUN)

FUNCTION BACnetRestoreBACnetDevice : IEC_BACNET_STATUS

Function initiates a restore for an BACnet device.

This function will start an restore procedure for the specified device.

InOut:

Scope

Name

Type

Comment

Return

BACnetRestoreBACnetDevice

IEC_BACNET_STATUS

Input

pInfo

POINTER TO IEC_BACNET_BACKUPRESTORE_INFO

Pointer to information which specifies which device should be restored and where the file object data is stored to be restored.

pICallback

CmpEventMgr.ICmpEventCallback

A pointer to the event-callback interface to inform about failures and progress information during the procedure execution.

pAPDUParams

POINTER TO IEC_BACNET_APDU_PROPERTIES

A pointer to the APDU-Properties structure which sets APDU properties for this transaction only. This does not change global defaults or settings for the application APDU Properties. This argument may be NULL. In this case APDU properties are used which were specified in the device object properties of the applications device which sends the request.

phTransaction

POINTER TO BYTE

The handle which identifies the transaction handled by the user application. The given handle has to be unique, in case the application needs to separate multiple pending requests. This handle is transparent for the BACnet API and is returned unchanged to the user application in the completion routine callback. This handle may be NULL, but the user application will be unable to cancel pending requests by a call to BACnetCancelPendingConfirmedRequest or to separate them in the callback if multiple completions are pending in such case.