DHCPV6PrefixLeaseInformation structure (dhcpv6csdk.h)

  • Article

The DHCPV6PrefixLeaseInformation structure contains information about a prefix lease.

Syntax

typedef struct _DHCPV6PrefixLeaseInformation {
  DWORD          nPrefixes;
  LPDHCPV6Prefix prefixArray;
  DWORD          iaid;
  time_t         T1;
  time_t         T2;
  time_t         MaxLeaseExpirationTime;
  time_t         LastRenewalTime;
  StatusCode     status;
  LPBYTE         ServerId;
  DWORD          ServerIdLen;
} DHCPV6PrefixLeaseInformation, *PDHCPV6PrefixLeaseInformation, *LPDHCPV6PrefixLeaseInformation;

Members

nPrefixes

Number of prefixes.

prefixArray

Pointer to a list DHCPV6Prefix structures that contain the prefixes requested or returned by the server.

iaid

Identity Association identifier for the prefix operation.

T1

The renewal time for the prefix, in seconds.

T2

The rebind time of the prefix, in seconds.

MaxLeaseExpirationTime

The maximum lease expiration time of all the prefix leases in this structure.

LastRenewalTime

The time at which the last renewal for the prefixes occurred.

status

Status code returned by the server for the IAPD. The following codes can be returned by the DHCP server for prefix delegation scenarios:

Value Meaning
STATUS_NO_ERROR
0
 The prefix was successfully leased or renewed.
STATUS_UNSPECIFIED_FAILURE
1
 The lease or renewal action failed for an unspecified reason.
STATUS_NO_BINDING
3
 The DHCPv6 server does not have a binding for the prefix.
STATUS_NOPREFIX_AVAIL
6
 The DHCPv6 server does not have a prefix available to offer the requesting client.

ServerId

The server DUID from which the prefix is received. This data is used in subsequent renews.

ServerIdLen

The length of the above DUID data.

Remarks

In a prefix delegation scenario, the validation of lease lifetime values (specific status codes, T1, T2, MaxLeaseExpirationTime, and LastRenewalTime) are performed by the calling API, rather than the application consuming the data, as the latter might interpret these values differently.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header dhcpv6csdk.h