DhcpDeleteFilterV4 function

The DhcpDeleteFilterV4 function deletes a link-layer address or address pattern from a DHCP server's allow/deny lists.

Syntax


DWORD WINAPI DhcpDeleteFilterV4(
  _In_ DHCP_CONST WCHAR  *ServerIpAddress,
  _In_ DHCP_ADDR_PATTERN *DeleteFilterInfo
);

Parameters

ServerIpAddress [in]

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

DeleteFilterInfo [in]

Pointer to a DHCP_ADDR_PATTERN structure that contains the link-layer address or address pattern filter to remove from the DHCP server database.

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
ERROR_ACCESS_DENIED

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

ERROR_DHCP_JET_ERROR

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

ERROR_DHCP_LINKLAYER_ADDRESS_DOES_NOT_EXIST

The address or address pattern does not exist in an allow/deny list.

ERROR_INVALID_PARAMETER

The address or address pattern supplied in DeleteFilterInfo is invalid.

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Dhcpsapi.h

Library

Dhcpsapi.lib

DLL

Dhcpsapi.dll

See also

DhcpAddFilterV4
DHCP_ADDR_PATTERN

 

 

Show: