dhcpV4DeletePolicy 函式 (dhcpsapi.h)

發行項
08/23/2023

DhcpV4DeletePolicy函式會從 DHCP 伺服器刪除現有的原則。

語法

DWORD DHCP_API_FUNCTION DhcpV4DeletePolicy(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName
);

參數

[in, optional] ServerIpAddress

Null 終止的 Unicode 字串指標，表示 DHCP 伺服器的 IP 位址或主機名稱。

[in] fGlobalPolicy

如果 為 TRUE ，則會刪除伺服器層級原則。否則，會刪除範圍層級原則。

[in] SubnetAddress

DHCP_IP_ADDRESS 結構，其中包含要刪除之原則的 IPv4 子網位址。

[in] PolicyName

Null 終止的 Unicode 字串，表示要刪除的原則名稱。

傳回值

如果函式成功，則會傳回 ERROR_SUCCESS。

如果函式失敗，它會傳回下列其中一個錯誤碼。

值	意義
ERROR_DHCP_SUBNET_NOT_PRESENT	指定的 IPv4 子網不存在。
ERROR_DHCP_POLICY_NOT_FOUND	找不到 DHCP 伺服器原則。
ERROR_INVALID_PARAMETER	參數無效。

需求


最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	dhcpsapi.h
程式庫	Dhcpsapi.lib
Dll	Dhcpsapi.dll