Zen API
 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
functionCallback function.
receiverCallback receiver.
Returns
Operation status.
See also
kNetwork_RemoveChangeHandler