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.

This function will only search for REMOTE object names and not LOCAL ones.

InOut:

Scope	Name	Type	Comment
Return	BACnetFindUpdateObjectIdNameBindings	POINTER TO IEC_BACNET_OBJECT_ID	A pointer to IEC_BACNET_OBJECT_ID or 0 if the object identifier is still unknown.
Input	devInst	IEC_BACNET_DWORD	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 0-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.