BACnetStack_DeleteBDTEntry

bool BACnetStack_DeleteBDTEntry(const uint16_t index);

Deletes an entry in the broadcast distribution table at the specified index.

Updates the host entry index in the router if it has changed.

This function takes no Network Port: it acts only on the broadcast distribution table of the BACnet/IP data link the stack uses when no Network Port is named, which belongs to the first BACnet/IP Network Port object added. BACnetStack_AddBDTEntry() and BACnetStack_GetBDTEntry() take a networkPortInstance, so with more than one BACnet/IP Network Port an entry added to, or read from, another port cannot be deleted through this function.

Note

Requires the STACK_OPTION_NM_BBMDC (with STACK_OPTION_DATA_LINK_LAYER_IPV4 and STACK_OPTION_OBJECT_TYPE_NETWORK_PORT) build option (it turns on STACK_OPTION_BVLL_BBMD, the macro this function checks).

BACnet reference: ANSI/ASHRAE 135-2024 Annex J: J.4.3.2 (Broadcast Distribution Table format).

Parameters

Parameter	Direction	Description
index	in	The index of the entry in the broadcast distribution table to delete.

Returns

True if successfully deleted; false if the index does not exist or is the host’s own entry.

Topic: BACnet/IP: BBMD and foreign devices. Declared in CASBACnetStackDLL.h.