DhcpV4QueryPolicyEnforcement 函式 (dhcpsapi.h)

發行項
02/26/2024

DhcpV4QueryPolicyEnforcement 函式會從 DHCP 伺服器擷取伺服器或指定的 IPv4 子網上的原則強制執行狀態。

語法

DWORD DHCP_API_FUNCTION DhcpV4QueryPolicyEnforcement(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [out]          BOOL            *Enabled
);

參數

[in, optional] ServerIpAddress

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

[in] fGlobalPolicy

如果 為 TRUE ，則會擷取伺服器的原則強制執行狀態。否則，會擷取指定 Ipv4 範圍的原則強制執行狀態。

[in] SubnetAddress

DHCP_IP_ADDRESS 結構，其中包含要擷取之原則強制執行狀態的IPv4子網位址。

[out] Enabled

指出原則強制執行狀態的 BOOL 指標。如果 為 TRUE ，則會啟用原則強制執行狀態。否則，原則強制執行狀態會停用。

注意呼叫端必須配置這個的記憶體。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	一或多個參數無效。
ERROR_DHCP_SUBNET_NOT_PRESENT	指定的 IPv4 子網不存在。

規格需求

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