Zen API

- Home
- Topics
- Types
- Files

All Classes Files Functions Variables Typedefs Friends Macros Modules Pages

kStatus kNetwork_AddChangeHandler | ( | kCallbackFx | function,
|  | kPointer | receiver
| ) |  |

Add a network change notification handler.

The registered callback will be invoked when network changes occur. Note, the callback may be invoked multiple times per visible change (underlying changes are not always surfaced in the high-level properties in this API).

When the callback is invoked, the 'receiver' argument passed to this function will be provided as the 'receiver' argument to the callback. The 'sender' and 'args' callback parameters are not used at this time.

Use the kNetwork_RemoveChangeHandler method to deregister the callback when notifications are no longer needed.

Parameters

  function | Callback function.
  receiver | Callback receiver.

Returns
  Operation status.

See also
  kNetwork_RemoveChangeHandler