The R_DhcpSetFilterV4 method is used to enable or disable the allow and deny lists. The DHCPv4 server allows the DHCPv4 clients whose link-layer address is in the allow list to be given leases and blocks DHCPv4 clients whose link-layer address is in the deny list, provided the respective lists are enabled using R_DhcpSetFilterV4.

 DWORD R_DhcpSetFilterV4(
   [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress,
   [in] DHCP_FILTER_GLOBAL_INFO* GlobalFilterInfo
 );

ServerIpAddress: The IP address/host name of the DHCP server. This parameter is unused.

GlobalFilterInfo: This is a pointer to a DHCP_FILTER_GLOBAL_INFO (section 2.2.1.2.91) that contains information to enable or disable allow and deny lists.

Return Values: A 32-bit unsigned integer value that indicates return status. A return value ERROR_SUCCESS (0x00000000) indicates that the operation was completed successfully, else it contains a Win32 error code, as specified in [MS-ERREF]. This error code value can correspond to a DHCP-specific failure, which takes a value between 20000 and 20099, or any generic failure.

Return value/code	Description
0x00000000 ERROR_SUCCESS	The call was successful.
0x00004E2D ERROR_DHCP_JET_ERROR	An error occurred while accessing the DHCP server database.

The opnum field value for this method is 84.

When processing this call, the DHCP server MUST do the following:

• Validate whether this method is authorized for read/write access per section 3.5.5. If not, return error ERROR_ACCESS_DENIED.

• If the GlobalFilterInfo is NULL, return error ERROR_INVALID_PARAMETER.

• Modify the server ADM element DHCPv4FilterStatus with the information in GlobalFilterInfo input parameter.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].