Previous

Next

Function xn_extend_dhcp_lease

Extends an existing IP address lease.

int xn_extend_dhcp_lease(DHCP_session * session, DWORD lease_time);

Parameters

session

Pointer to DHCP_session that was passed to xn_dhcp.

lease_time

The desired lease time in seconds.

return value

Returns 0 if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. In addition to the error values listed below, all errors returned by recvfrom and sendto may also be set. Error Codes further describes each error.

Possible values for this function are:

This routine extends an IP address lease obtained by a previous call to xn_dhcp. It cannot be used once an IP address lease has expired. When an IP address lease has expired, you must obtain a new IP address lease through xn_dhcp. If the function succeeds, session->lease_time will contain the lease time returned by the server.

It is usually not required to call xn_extend_dhcp_lease explicitly. xn_dhcp will extend a lease automatically in the background.

DHCP Client

Function xn_dhcp_release

Function xn_get_dhcp_op