BACnetStack_SendCancelSubscribeCOV

bool BACnetStack_SendCancelSubscribeCOV(
  uint8_t * sentInvokeId,
  const uint32_t subscriberProcessIdentifier,
  const uint16_t monitoredObjectType,
  const uint32_t monitoredObjectInstance,
  const uint8_t * connectionString,
  const uint8_t connectionStringLength,
  const uint32_t networkPortInstance,
  const uint16_t destinationNetwork,
  const uint8_t * destinationAddress,
  const uint8_t destinationAddressLength);

Sends a confirmed SubscribeCOV request with no issueConfirmedNotifications/lifetime (a cancellation), ending a previously established COV subscription for the given subscriber process on the given object.

Note

Requires one of the build options STACK_OPTION_DS_COVU_B, STACK_OPTION_DS_COV_SUBSCRIBE_COV (any of them turns on STACK_OPTION_SUBSCRIBE_COV, the macro this function checks).

See also: Client response hooks

BACnet reference: ANSI/ASHRAE 135-2024 clause 13.14 (SubscribeCOV Service).

Parameters

Parameter	Direction	Description
sentInvokeId	out	The invoke-id of the sent request, valid only if this function returns true.
subscriberProcessIdentifier	in	The process identifier of the subscription to cancel.
monitoredObjectType, monitoredObjectInstance	in	The object the subscription was made against. The type and instance are one BACnet Object Identifier carried as two parameters (see the API conventions).
connectionString, connectionStringLength	in	The datalink address to send TO (the destination) - not the local address to send from. For IPv4 this is 6 bytes: 4 octets of IPv4 address followed by 2 octets of port, big-endian (e.g. 0xC0,0xA8,0x01,0x05,0xBA,0xC0 = 192.168.1.5:47808; see BACnetStack_SendRegisterForeignDevice() for a worked example); on BACnet/IPv4 the stack refuses to send to a connection string of any other length, except that a broadcast from a device registered as a foreign device goes to its BBMD and does not use the connection string. MS/TP and BACnet/SC use a different connection-string shape; see their respective Set/Send exports.
networkPortInstance	in	The Network Port object instance to send the message on, or BACNET_NETWORK_PORT_DEFAULT (4194303) for the default/single port.
destinationNetwork, destinationAddress, destinationAddressLength	in	The destination to send the request to.

Returns

True if the request was sent, otherwise false.

Topic: Client requests. Declared in CASBACnetStackDLL.h.