tfDhcpConfRenewLease

Table of Contents >> Optional Protocols >> DHCP Automatic Configuration

#include <trsocket.h>

int tfDhcpConfRenewLease	(
	ttUserInterface interfaceHandle,
	int multiHomeIndex,
	ttUser32Bit timeoutMilliSecs,
	unsigned int retries
	);

Function Description

Force DCHP to renew the IP address lease for an individual multihomed index on an interface. This may be necessary if there is some external indication that the IP address may no longer be valid (e.g. Ethernet or wireless link disconnect/reconnect).

Parameters

• interfaceHandle

  The device entry as returned by tfAddInterface().

• multiHomeIndex

  Index of the DHCP autoconfigured IPv4 address on interfaceHandle.

• timeoutMilliSecs

  Retransmission interval time for DHCPREQUEST message (non-zero, milliseconds).

• retries

  Maximum number of transmission attempts (1 to 255).

Returns

• TM_ENOERROR

  Success.

• TM_EINPROGRESS

  No error. Operation is in progress.

• TM_EINVAL

  Invalid parameter.

• TM_EPERM

  Can't renew lease because no lease has been obtained.

• TM_EALREADY

  Lease renewal already in progress.

Table of Contents >> Optional Protocols >> DHCP Automatic Configuration