Collapse the table of content
Expand the table of content

DhcpEnumSubnetClientsVQ function

The DhcpEnumSubnetClientsVQ function retrieves all DHCP clients serviced from the specified IPv4 subnet.


DWORD WINAPI DhcpEnumSubnetClientsVQ(
  _In_    DHCP_CONST WCHAR            *ServerIpAddress,
  _In_    DHCP_IP_ADDRESS             SubnetAddress,
  _Inout_ DHCP_RESUME_HANDLE          *ResumeHandle,
  _In_    DWORD                       PreferredMaximum,
  _Out_   DWORD                       *ClientsRead,
  _Out_   DWORD                       *ClientsTotal


ServerIpAddress [in]

Unicode string that specifies the IP address or hostname of the DHCP server.

SubnetAddress [in]

DHCP_IP_ADDRESS value that contains the IPv4 subnet for which the DHCP clients are returned. If this parameter is set to 0, the DHCP clients for all known IPv4 subnets are returned.

ResumeHandle [in, out]

Pointer to a DHCP_RESUME_HANDLE value that identifies the enumeration operation on the DHCP server. Initially, this value must be set to 0. A successful call will return a handle value in this parameter, which can be passed to subsequent enumeration requests. The returned handle value is the last IPv4 address retrieved in the enumeration operation.

PreferredMaximum [in]

Specifies the preferred maximum number of bytes to return in the enumeration operation. the minimum value is 1024 bytes, and the maximum value is 65536 bytes.

ClientInfo [out]

Pointer to a DHCP_CLIENT_INFO_ARRAY_VQ structure that contains the DHCP client lease record set returned by the enumeration operation.

ClientsRead [out]

Pointer to a value that specifies the number of DHCP client records returned in ClientInfo.

ClientsTotal [out]

Pointer to a value that specifies the number of DHCP client record remaining and as-yet unreturned. For example, if there are 100 DHCP client records for a given IPv4 subnet, and if 10 client records are enumerated per call, then after the first call this value would return 90.

Return value

This function returns ERROR_SUCCESS upon a successful call. Otherwise, it returns one of the DHCP Server Management API Error Codes.

Return codeDescription

This call was performed by a client who is not a member of the "DHCP Administrators" security group.


An error occurred while accessing the DHCP server's database.


There are still unenumerated client lease records on the DHCP server for the provided IPv4 subnet. Please call this function again with the returned resume handle to obtain more of them.



If SubnetAddress is set to zero (0), then all of the DHCP clients from all known IPv4 subnets.

The caller of this function must free the data pointed to by ClientInfo.


Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]









© 2016 Microsoft