1.2.1.3.18 TCPIP_DHCP_Request Function

bool TCPIP_DHCP_Request(
    TCPIP_NET_HANDLE hNet, 
    IPV4_ADDR reqAddress
);

If the DHCP client is not enabled on that interface, this call will first try to enable it. If this succeeds or the DHCP client was already enabled, the following steps are taken: The DHCP client probes the DHCP server and requests the supplied IPv4 address as a valid lease for the specified interface. If the server acknowledges the request, then this is the new IPv4 address of the interface. If the DHCP server rejects the request, then the whole DHCP process is resumed starting with the DHCP Discovery phase.

The DHCP module must be initialized.

• True - If successful.

• False - If the supplied IP address is invalid or the DHCP client is in the middle of a transaction.

The requested IPv4 address should be a previous lease that was granted to the host. This call should be used when the host is restarting.