dhcpAddFilterV4 函式 (dhcpsapi.h)

  • 發行項

DhcpAddFilterV4 函式會將連結層位址或位址模式新增至允許/拒絕清單。

語法

DWORD DHCP_API_FUNCTION DhcpAddFilterV4(
  [in] DHCP_CONST WCHAR     *ServerIpAddress,
  [in] DHCP_FILTER_ADD_INFO *AddFilterInfo,
  [in] BOOL                 ForceFlag
);

參數

[in] ServerIpAddress

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

[in] AddFilterInfo

包含連結層位址或位址模式 的DHCP_FILTER_ADD_INFO 結構的指標，以新增至 DHCP 伺服器的允許/拒絕清單。

[in] ForceFlag

如果 為 TRUE，則會覆寫任何現有的相符篩選;如果 為 FALSE，則呼叫失敗並 出現ERROR_DHCP_LINKLAYER_ADDRESS_EXISTS。

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器的資料庫時發生錯誤。
ERROR_DHCP_LINKLAYER_ADDRESS_EXISTS
 位址或位址模式已存在於允許/拒絕清單中。

備註

此 API 可讓已將位址新增至允許清單的 DHCP 用戶端取得租用，並封鎖新增至拒絕清單的用戶端。 必須啟用個別清單，並呼叫 DhcpSetFilterV4。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 dhcpsapi.h
程式庫 Dhcpsapi.lib
Dll Dhcpsapi.dll

另請參閱

DHCP_FILTER_ADD_INFO

DhcpSetFilterV4