BACnetUnregisterClientDataPoint (FUN)
FUNCTION BACnetUnregisterClientDataPoint : IEC_BACNET_STATUS
Releases an device object property reference from data acquisation.
The user application can remove device object property references from data acquisation which it doesn’t need anymore. If the user application has registered an callback for unsubscribe completion, it will get notified about the successful or unsuccessful unsubscription asynchronously.
::BACNET_STATUS BACNET_STATUS_BUSY: if unsubscription is pending. The registered unsubscribe-complete callback will be called on completion to indicate that unregistration has been completed. BACNET_STATUS_OK: unsubscription completed. The registered unsubscribe-complete callback WILL NOT BE CALLED because other customers have an active registration on the same reference OR the data is retrieved by polling using read property or read property multiple. OTHER: some other failure in given parameters has been detected
- InOut:
Scope
Name
Type
Comment
Return
BACnetUnregisterClientDataPointInput
hCustomerAn handle to an created advanced BACnet client customer created by ::BACnetOpenClientCustomer.
devIdThe device instance number from the remote or local device from which the value shall not be acquired anymore.
pObjIdPOINTER TO IEC_BACNET_OBJECT_ID
A pointer to the object identifier from the remote or local object from which the value shall not be acquired anymore.
propIdThe property identifier from which the value shall not be acquired anymore.
indexThe property array index from which the value shall not be acquired anymore.
bClockAlignedPollingIf set to True the acquisation will be stopped for the clock aligned registered reference. If set to False the NON clock aligned reference will be removed.
bForceUnsubscribeIf set to True the unsubscription will be executed with nininmal delay instead of waiting for the next device alive check or waiting for new registrations.