User`s guide
168
K
A
DAK
KwikNet Low Level Services
kn_netevent kn_netevent
Purpose Notify Application of Significant Network Event (User Function)
Used by
n Task o ISP o Timer Procedure o Restart Procedure n Exit Procedure
Setup Prototype is in file KN_API.H.
#include "KN_LIB.H"
void kn_netevent(KN_NETDP netdp, int eventid);
Description KwikNet calls this user function whenever a signficant network event has
been detected. Your application must provide this function.
Netdp is a network descriptor pointer, the KwikNet handle used to identify
the network interface which has generated the significant event.
Parameter eventid identifies the significant event. This parameter will be
one of the following constants defined in file KN_API.H.
KN_EV_DVCRESET Device reset failure
KN_EV_DVCFAIL Device failed
KN_EV_DVCDOWN Device is down
KN_EV_DVCUP Device is up
KN_EV_MODEM Modem failed (lost carrier)
KN_EV_NETADD Network interface added
KN_EV_NETDOWN Network is closed
KN_EV_NETUP Network is open and usable
KN_EV_NETTRANS Network in transit (going up/down)
KN_EV_NETFAIL Network state transition failed
KN_EV_DHCPOK DHCP or BOOTP acquired IP address
KN_EV_DHCPFAIL DHCP failed to acquire an IP address or renew lease
KN_EV_AIPOK Auto IP acquired IP address
KN_EV_AIPFAIL Auto IP failed to acquire IP address
KN_EV_V6_START Duplicate Address Detection (DAD) started
KN_EV_V6_FAIL IPv6 DAD failed
KN_EV_V6_GOOD IPv6 DAD successfully completed
KN_EV_V6_DUP Conflict on address already granted
KN_EV_V6_DEPR Address deprecated
KN_EV_V6_INVAL Address invalidated
Returns Nothing
Restriction This function is not a
KwikNet procedure. It is a function that your
application must provide. KwikNet will call your function if your KwikNet
Library has network event notification enabled. To do so, edit your
KwikNet Network Parameter File and check the option box labeled "Enable
network event notification"
on the General property page. Then rebuild your
KwikNet Library.
See Also
kn_ifadd(), kn_ifclose(), kn_ifopen()