FireSync API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kStatus kSystem_SetNodeFilter ( kSystem  system,
kNodeFilterFx  filter,
kPointer  receiver 
)

Registers a callback function that can be used to filter discovered nodes.

If a filter callback will be used, it should be registered prior starting the discovery with kStartDiscovery. The callback must not be changed while discovery is running.

The callback function will be asynchronously invoked in a background thread. It can be called at any time, until the callback is unregistered. Various internal locks may be held by the thread that invokes the callback; accordingly, the implementation of the callback should avoid acquiring any locks that might result in deadlock.

Parameters
systemkSystem object.
filterCallback function.
receiverReceiver of the callback.
Returns
Operation status.