Developer

API Reference

INetwork_OnEvent()

Brew Release
Brew MP 1.0.2
See Also
Description
This function allows the caller to register to receive notifications of network status changes and events. A single callback function can be registered for each event type. The registration is in effect until overridden by a new registration for the same event type or canceled by a call to this function for the same event type with bRegister set to FALSE.
Parameters
  • me
    []:
    The interface pointer.
  • nEvent
    []:
    Event to register for (NETWORK_EVENT_*).
  • pfn
    []:
    User callback to be called when an event of type nEvent occurs.
  • pUser
    []:
    User-specific data. This data shall be passed back to the application in the callback function.
  • bRegister
    []:
    TRUE to set up the registration. FALSE to cancel existing registration.
Interface
Prototype
    int INetwork_OnEvent(INetwork *me, int nEvent, PFNNETWORKEVENT pfn, void *pUser, boolean bRegister);
Return
AEE_SUCCESS: if registered AEE_EBADPARM: if nEvent is invalid or pfn is NULL AEE_ENOMEMORY: if allocation failure AEE_EALREADY: if already registered Other error code : as appropriate.
Side Effect
None.
Comment
None.
  • Follow