BACnetFindUpdateObjectIdNameBindings (FUN)¶

FUNCTION BACnetFindUpdateObjectIdNameBindings : POINTER TO IEC_BACNET_OBJECT_ID

Finds or updates an object identifier for some specified object name.

The Who-Has service is used by a sending BACnet-user to identify the device object identifiers and network addresses of other BACnet devices whose local databases contain an object with a given Object_Name or a given Object_Identifier. This function implements the functional process of dynamic object binding. The API will send in configurable periods (see function ::BACnetSetObjectIdNameBindingsCacheOptions) requests to retrieve the right object identifier for an specified object name.n This function will only search for b REMOTE object names and not b LOCAL ones.

Return: A pointer to ::BACNET_OBJECT_ID or NULL if the object identifier is still unknown.

InOut:

Scope	Name	Type	Comment
Return	`BACnetFindUpdateObjectIdNameBindings`	POINTER TO IEC_BACNET_OBJECT_ID
Input	`devInst`	IEC_BACNET_INST_NUMBER	The device instance number for which the object binding shall be retrieved or updated.
	`pObjectName`	POINTER TO IEC_BACNET_STRING	A pointer to a string structure filled with the object name to search for.
	`pInObjId`	POINTER TO IEC_BACNET_OBJECT_ID	A pointer to an object identifier associated to the given name or a NULL pointer if the given object name should be resolved into an object identifier.
	`bForceRefresh`	IEC_BACNET_BOOLEAN	If set to True the dynamic object binding is forced to be refreshed for the given object name.