DhcpSetOptionValuesV5 函式 (dhcpsapi.h)

DhcpSetOptionValuesV5函式會針對 DHCP 伺服器上定義的特定範圍，設定選項碼及其相關聯的資料值。 此函式可讓呼叫端指定選項的類別和/或廠商，藉此擴充 DhcpSetOptionValues 所提供的功能。

語法

DWORD DhcpSetOptionValuesV5(
  [in] LPWSTR                    ServerIpAddress,
  [in] DWORD                     Flags,
  [in] LPWSTR                    ClassName,
  [in] LPWSTR                    VendorName,
  [in] LPDHCP_OPTION_SCOPE_INFO  ScopeInfo,
  [in] LPDHCP_OPTION_VALUE_ARRAY OptionValues
);

參數

[in] ServerIpAddress

指定 DHCP 伺服器的 IPv4 位址的 Unicode 字串。

[in] Flags

此參數必須設定為 0，並在收到時忽略。

[in] ClassName

指定選項 DHCP 類別的 Unicode 字串。 這是選擇性參數。

[in] VendorName

指定選項廠商的 Unicode 字串。 如果未指定廠商類別，則會為預設廠商類別設定選項值。 這是選擇性參數。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO結構的指標，其中包含描述這些選項值之 DHCP 範圍的資訊， 這個參數會指出選項值是針對預設、伺服器或範圍層級，還是針對 IPv4 保留設定。

[in] OptionValues

DHCP_OPTION_VALUE_ARRAY結構的指標，其中包含選項碼清單，以及要為其設定的對應資料值。

傳回值

此函式會在成功呼叫時 傳回ERROR_SUCCESS 。 否則，它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。

傳回碼	描述
ERROR_DHCP_JET_ERROR	存取 DHCP 伺服器資料庫時發生錯誤。
ERROR_DHCP_SUBNET_NOT_PRESENT	DHCP 伺服器上沒有指定的 IPv4 子網。
ERROR_DHCP_OPTION_NOT_PRESENT	在 DHCP 伺服器資料庫中找不到指定的選項定義。
ERROR_DHCP_NOT_RESERVED_CLIENT	指定的 DHCP 用戶端不是 IPv4 保留的用戶端。
ERROR_DHCP_CLASS_NOT_FOUND	在 DHCP 伺服器資料庫中找不到指定的類別名稱。

備註

呼叫完成之後，此函式的呼叫端必須釋放 OptionValues 所指向的記憶體。

需求

最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	dhcpsapi.h
程式庫	Dhcpsapi.lib
Dll	Dhcpsapi.dll

另請參閱

DHCP_OPTION_SCOPE_INFO

DHCP_OPTION_VALUE_ARRAY

DhcpSetOptionValueV5

DhcpSetOptionValues