2.2.1.2.17 DHCP_CLIENT_INFO_ARRAY_V5

  • Article

The DHCP_CLIENT_INFO_ARRAY_V5 structure defines the array of DHCP_CLIENT_INFO_V5 (section 2.2.1.2.16) structures.

This structure is used by methods, such as R_DhcpEnumSubnetClientsV5 (section 3.2.4.1), that retrieve information for more than one DHCPv4 client. 

 typedef struct _DHCP_CLIENT_INFO_ARRAY_V5 {
   DWORD NumElements;
   [size_is(NumElements)] LPDHCP_CLIENT_INFO_V5* Clients;
 } DHCP_CLIENT_INFO_ARRAY_V5,
  *LPDHCP_CLIENT_INFO_ARRAY_V5;

NumElements: This is of type DWORD, containing the number of DHCPv4 client–specific subnets, which is also the number of DHCPv4 clients in the Clients member element. There are no inherent restrictions on the NumElements member. Methods that retrieve DHCPv4 client information using the DHCP_CLIENT_INFO_ARRAY_V5 structure can limit the maximum value of the NumElements member. For example, R_DhcpEnumSubnetClientsV5 restricts the number of elements based on input parameters and the size, as well as the number, of DHCPv4 client lease records available for retrieval.

Clients: This is a pointer of type DHCP_CLIENT_INFO_V5 that points to the array of length NumElements containing the DHCPv4 client's information.