AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide download pdf (Page 171)

KwikNet Low Level Services

DAK

157

kn_ifclose kn_ifclose

Purpose Close a Network Interface

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"

int kn_ifclose(KN_NETDP netdp);

Description Netdp is a network descriptor pointer, the KwikNet handle used to identify

the network interface of interest.

Returns If the network interface is successfully closed or was already closed, a

value of 0 is returned.

If the network interface is in transit but not yet closed, a warning status of

KN_WRPROGRESS is returned.

On failure, one of the following error status codes is returned:

KN_ERPARAM Parameter netdp does not refer to a valid network.

KN_ERNETWORK An unexpected network error occurred.

The network is down but may not be reusable.

Note You can close a prebuilt network interface and then open it with an

alternate set of network configuration parameters. Of course, you can also

reopen the network interface with the configuration unaltered.

Note Your network event function (see kn_netevent()) will be called allowing

you to monitor each network state transition.

No comments

AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide Page 171