BACnetStack_SetMaxSupportedCOVLifetime

bool BACnetStack_SetMaxSupportedCOVLifetime(
  const uint32_t deviceInstance,
  const uint32_t maxSupportedCOVLifetime);

Sets ONLY the maximum supported COV lifetime for subscriptions received by this device.

The atomic, single-purpose half of BACnetStack_SetCOVSettings(). See that function’s doc for the lifetime semantics (reject-not-clamp, the 28800-second default, and the 0-sentinel behaviour) - they are identical here.

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).

BACnet reference: ANSI/ASHRAE 135-2024 clause 13.1 (Change of Value Reporting).

Parameters

Parameter	Direction	Description
deviceInstance	in	The instance of the device to configure.
maxSupportedCOVLifetime	in	The maximum supported COV lifetime in seconds. Valid range is 0 .. MAX_UINT32 - 1; exactly MAX_UINT32 is rejected. Pass 28800 for the device default, or 0 to substitute the same default.

Returns

True if successful, false if failed.

Topic: Device and services. Declared in CASBACnetStackDLL.h.