Start dynamic IP address configuration for an interface.
Files
net_ip.h/net_ip.c
Prototype
Arguments
if_nbr
Interface number to start dynamic address configuration.
perr
Pointer to variable that will receive the return error code from this function:
NET_IP_ERR_NONE
NET_IP_ERR_ADDR_CFG_STATE
NET_IP_ERR_ADDR_CFG_IN_PROGRESS
NET_IF_ERR_INVALID_IF
NET_OS_ERR_LOCK
Returned Value
DEF_OK
,
if dynamic IP address configuration successfully started;
DEF_FAIL
,
otherwise.
Required Configuration
None.
Notes / Warnings
This function should only be called by appropriate network application function(s) [e.g., DHCP initialization functions]. However, if the application attempts to dynamically configure IP address(es), it must call NetIP_CfgAddrAddDynamicStart()
before calling NetIP_CfgAddrAddDynamic()
.