DhcpV4CreatePolicy 函式 (dhcpsapi.h)

DhcpV4CreatePolicy函式會在 DHCP 伺服器上建立新的原則。

語法

DWORD DHCP_API_FUNCTION DhcpV4CreatePolicy(
  [in, optional] LPWSTR        ServerIpAddress,
  [in]           LPDHCP_POLICY pPolicy
);

[in, optional] ServerIpAddress

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

[in] pPolicy

包含要建立之原則參數的DHCP_POLICY 結構的指標。

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

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

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