tfDhcpUserRenewLease

Table of Contents >> Optional Protocols >> DHCP User Configured

#include <trsocket.h>

int tfDhcpUserRenewLease	(
	ttUserInterface interfaceHandle,
	int userIndex,
	ttUser32Bit timeoutMilliSecs,
	unsigned int retries
	);

Function Description

Force DCHP to renew the IP address lease for an individual user-controlled 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().

• userIndex

  Index of the DHCP user-controlled 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 User Configured