BACnetStack_AddBACnetSCAcceptUri

bool BACnetStack_AddBACnetSCAcceptUri(
  const uint32_t deviceInstance,
  const uint32_t scPortInstance,
  const uint8_t connectionRole,
  const char * acceptUri,
  const uint32_t acceptUriLength);

Adds one accept URI to a Secure Connect Network Port’s hub function or direct connect role.

cl. 12.56.91/.96 make SC_Hub_Function_Accept_URIs and SC_Direct_Connect_Accept_URIs each a BACnetARRAY of CharacterString - a device with multiple interfaces can advertise every URI a peer might use to reach it (the spec’s own binding example is “eth0:4443,eth1:8080”). Takes effect immediately, not staged behind Changes_Pending like the certificate setters - there is no “commit” concept for this list: a URI either validates and is added now, or is rejected outright. If the role is already listening, this also starts a websocket listener for the new URI alone; existing listeners are untouched. Duplicate URIs on the same role are rejected.

Note

URI lengths are limited to BACnetSCConstants::BACNET_SC_MAX_URI_LENGTH (255); longer URIs are rejected.

Note

Requires the STACK_OPTION_DATA_LINK_LAYER_SC (with STACK_OPTION_DATA_LINK_LAYER_IPV4) build option.

Parameters

Parameter	Direction	Description
deviceInstance, scPortInstance	in	The device and Network Port object representing this SC connection.
connectionRole	in	Which accept-URI list to add to: 0 - hub function (SC_Hub_Function_Accept_URIs) 1 - direct connect (SC_Direct_Connect_Accept_URIs) Any other value is rejected.
acceptUri, acceptUriLength	in	The URI to add. Must use the wss scheme.

Returns

True if successful, false if failed.

Topic: BACnet/SC. Declared in CASBACnetStackDLL.h.