OpenDOF Project
void(* DOFInterestListener::DOFInterestListenerFns_t::InterestAdded)(DOFInterestListener self, DOF dof, DOFRequest request, DOFObjectID objectID, DOFInterfaceID interfaceID, DOFInterestLevel level)

Called when the node receives any level of interest for a binding.

Program this function to monitor interest requests. The DOFRequest is passed in this function for informational purposes, but this function should not be used to respond to the request.

This callback may be NULL to ignore notifications about interest being added.

Parameters
selfThe listener object. This will never be NULL.
dofThe DOF where this listener was added. This will never be NULL.
requestAn object that contains information about the request. This will never be NULL.
objectIDThe DOFObjectID the requestor has expressed interest in. This will never be NULL. This may be DOFOBJECTID_BROADCAST, indicating that the interest is for the specified interface on all objects. It will not be DOFOBJECTID_BROADCAST if the interfaceID is DOFINTERFACEID_WILDCARD.
interfaceIDThe DOFInterfaceID the requestor has expressed interest in. This will never be NULL. This may be DOFINTERFACEID_WILDCARD, indicating that the interest is for all interfaces on the specified object. It will not be DOFINTERFACEID_WILDCARD if the objectID is DOFOBJECTID_BROADCAST.
levelThe level of interest being added. This will never be NULL.
core-c-dof-oal Version 7.1.7 Build 0
2017-10-31