DhcpHlprCreateV4Policy 函式 (dhcpsapi.h)

發行項
03/05/2024

DhcpHlprCreateV4Policy 函式會配置並初始化 DHCP 伺服器原則結構。

語法

DWORD DHCP_API_FUNCTION DhcpHlprCreateV4Policy(
  [in]  LPWSTR              PolicyName,
  [in]  BOOL                fGlobalPolicy,
  [in]  DHCP_IP_ADDRESS     Subnet,
  [in]  DWORD               ProcessingOrder,
  [in]  DHCP_POL_LOGIC_OPER RootOperator,
  [in]  LPWSTR              Description,
  [in]  BOOL                Enabled,
  [out] LPDHCP_POLICY       *Policy
);

參數

[in] PolicyName

Null 終止的 Unicode 字串，其中包含要建立的 DHCP 伺服器原則名稱。

[in] fGlobalPolicy

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

[in] Subnet

DHCP_IP_ADDRESS 結構，其中包含要建立的範圍層級原則 IPv4 子網位址。

[in] ProcessingOrder

指定 DHCP 伺服器原則處理順序的整數。 1 表示最高優先順序， MAX_DWORD 表示最低。

[in] RootOperator

DHCP_POL_LOGIC_OPER 列舉，定義原則條件如何根據其組成結果進行評估。

[in] Description

包含 DHCP 伺服器原則描述之 Null 終止 Unicode 字串的指標。

[in] Enabled

如果已啟用原則，則為TRUE。否則為 FALSE。

[out] Policy

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

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	一或多個參數無效。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足。

規格需求

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