DhcpEnumSubnetClientsFilterStatusInfo function (dhcpsapi.h)

The DhcpEnumSubnetClientsFilterStatusInfo function enumerates all of the DHCP clients serviced on the specified subnet, and includes link-layer filter status for each of them.

Syntax

DWORD DHCP_API_FUNCTION DhcpEnumSubnetClientsFilterStatusInfo(
  [in]      DHCP_CONST WCHAR                       *ServerIpAddress,
  [in]      DHCP_IP_ADDRESS                        SubnetAddress,
  [in, out] DHCP_RESUME_HANDLE                     *ResumeHandle,
  [in]      DWORD                                  PreferredMaximum,
  [out]     LPDHCP_CLIENT_FILTER_STATUS_INFO_ARRAY *ClientInfo,
  [out]     DWORD                                  *ClientsRead,
  [out]     DWORD                                  *ClientsTotal
);

Parameters

[in] ServerIpAddress

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

[in] SubnetAddress

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.

[in, out] ResumeHandle

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.

[in] PreferredMaximum

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.

[out] ClientInfo

Pointer to a DHCP_CLIENT_FILTER_STATUS_INFO_ARRAY structure that contains all of the DHCP clients serviced on the specified subnet, as well as any associated link-layer filter status information for each of them.

[out] ClientsRead

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

[out] ClientsTotal

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.

Requirements

See also

DHCP_CLIENT_FILTER_STATUS_INFO_ARRAY