DhcpSetFilterV4 函式 (dhcpsapi.h)

DhcpSetFilterV4 函式會啟用或停用 DHCP 伺服器上的允許和拒絕清單。

語法

DWORD DHCP_API_FUNCTION DhcpSetFilterV4(
  [in] DHCP_CONST WCHAR        *ServerIpAddress,
  [in] DHCP_FILTER_GLOBAL_INFO *GlobalFilterInfo
);

[in] ServerIpAddress

指定 DHCP 伺服器的 IP 位址或主機名的 Unicode 字串指標。

[in] GlobalFilterInfo

DHCP_FILTER_GLOBAL_INFO結構的指標，其中包含用來啟用或停用允許和拒絕清單的資訊。

此函式會在成功呼叫時傳回 ERROR_SUCCESS 。否則，它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。

傳回碼	Description
ERROR_ACCESS_DENIED	此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR	存取 DHCP 伺服器的資料庫時發生錯誤。
ERROR_INVALID_PARAMETER	其中一個參數提供無效的值。

啟用篩選時，DHCP 伺服器允許在 [允許] 清單中提供與連結層地址相關聯的 DHCP 用戶端，並封鎖與「拒絕」清單中地址相關聯的 DHCP 用戶端。