DhcpHlprAddV4PolicyCondition 函式 (dhcpsapi.h)

發行項
02/26/2024

DhcpHlprAddV4PolicyCondition 函式會配置、初始化和新增 DHCP 伺服器原則條件至 DHCP 伺服器原則。

語法

DWORD DHCP_API_FUNCTION DhcpHlprAddV4PolicyCondition(
  [in, out] LPDHCP_POLICY       Policy,
  [in]      DWORD               ParentExpr,
  [in]      DHCP_POL_ATTR_TYPE  Type,
  [in]      DWORD               OptionID,
  [in]      DWORD               SubOptionID,
  [in]      LPWSTR              VendorName,
  [in]      DHCP_POL_COMPARATOR Operator,
            LPBYTE              Value,
  [in]      DWORD               ValueLength,
  [out]     DWORD               *ConditionIndex
);

參數

[in, out] Policy

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

[in] ParentExpr

整數，指定對應至這個構成條件的表達式索引。

[in] Type

DHCP_POL_ATTR_TYPE 列舉，指定此條件的屬性類型。

[in] OptionID

DHCP_OPTION_ID 值，這個值會根據 DHCP 選項或子選項指定準則的唯一選項標識碼。

[in] SubOptionID

DHCP_OPTION_ID 值，這個值會根據 DHCP 子選項指定準則的唯一子選項識別碼。

[in] VendorName

代表廠商名稱之 Null 終止 Unicode 字串的指標。

[in] Operator

DHCP_POL_COMPARATOR 列舉，指定條件的比較運算符。

Value

位元組陣列的指標，其中包含要用於比較的值。

[in] ValueLength

指定 Value 長度的整數。

[out] ConditionIndex

DWORD 的指標，其中包含 DHCP 伺服器原則中新建立條件的索引。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	一或多個參數無效。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足。
ERROR_DHCP_POLICY_BAD_PARENT_EXPR	指定的父表達式不存在。

規格需求

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