DhcpV4SetPolicy 函式 (dhcpsapi.h)

發行項
02/26/2024

DhcpV4SetPolicy 函式會更新現有原則的一或多個參數。

語法

DWORD DHCP_API_FUNCTION DhcpV4SetPolicy(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           DWORD           FieldsModified,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName,
  [in]           LPDHCP_POLICY   Policy
);

參數

[in, optional] ServerIpAddress

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

[in] FieldsModified

定義要修改之 DHCPv4 原則欄位之DHCP_POLICY_FIELDS_TO_UPDATE 列舉的值。

[in] fGlobalPolicy

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

[in] SubnetAddress

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

[in] PolicyName

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

[in] Policy

包含要修改之原則參數之DHCP_POLICY 結構的指標。

傳回值

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

如果函式失敗，它會從 DHCP 伺服器管理 API 錯誤碼傳回下列其中一個錯誤碼或錯誤碼。

值	意義
ERROR_INVALID_PARAMETER	一或多個參數無效。
ERROR_DHCP_SUBNET_NOT_PRESENT	指定的 IPv4 子網不存在。
ERROR_DHCP_RANGE_INVALID_IN_SERVER_POLICY	已針對伺服器層級原則指定原則範圍。
ERROR_DHCP_INVALID_POLICY_EXPRESSION	原則的指定條件或表達式無效。
ERROR_DHCP_POLICY_RANGE_BAD	指定的原則範圍不包含在範圍的IP位址範圍內，或指定的原則範圍無效。
ERROR_DHCP_POLICY_RANGE_EXISTS	指定的原則範圍會與指定範圍內現有原則的原則範圍重疊。
ERROR_DHCP_INVALID_PROCESSING_ORDER	指定的處理順序大於指定層級上現有原則的處理順序上限， (伺服器或範圍) 。
ERROR_DHCP_CLASS_NOT_FOUND	原則條件中的廠商類別或使用者類別參考不存在。

規格需求

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