NetIP_GetAddrHost()
Get an interface’s configured IP host address(es).
Files
net_ip.h/net_ip.c
Prototype
|
CPU_BOOLEAN NetIP_GetAddrHost(NET_IF_NBR if_nbr, NET_IP_ADDR *paddr_tbl, NET_IP_ADDRS_QTY *paddr_tbl_qty, NET_ERR *perr); |
Arguments
if_nbr
Interface number to get configured IP host address(es).
paddr_tbl
Pointer to IP address table that will receive the IP host address(es) in host-order for this interface.
paddr_tbl_qty
Pointer to a variable to:
Pass the size of the address table, in number of IP addresses, pointed to by paddr_tbl.
Returns the actual number of IP addresses, if no errors.
Returns 0, otherwise.
perr
Pointer to variable that will receive the error code from this function:
NET_IP_ERR_NONE
NET_IP_ERR_NULL_PTR
NET_IP_ERR_ADDR_NONE_AVAIL
NET_IP_ERR_ADDR_CFG_IN_PROGRESS
NET_IP_ERR_ADDR_TBL_SIZE
NET_IF_ERR_INVALID_IF
NET_OS_ERR_LOCK
Returned Value
DEF_OK,
if interface’s configured IP host address(es) successfully returned;
DEF_FAIL,
otherwise.
Required Configuration
None.
Notes / Warnings
IP addresses returned in host-order.