DhcpSetOptionValueV5 函式 (dhcpsapi.h)

  • 發行項

DhcpSetOptionValueV5 函式會設定 DHCP 伺服器上特定選項值的資訊。 此函式允許呼叫端指定選項的類別和/或廠商，藉此擴充 DhcpSetOptionValue 所提供的功能。

語法

DWORD DhcpSetOptionValueV5(
  [in]           LPWSTR                   ServerIpAddress,
  [in]           DWORD                    Flags,
  [in]           DHCP_OPTION_ID           OptionId,
  [in, optional] LPWSTR                   ClassName,
  [in, optional] LPWSTR                   VendorName,
  [in]           LPDHCP_OPTION_SCOPE_INFO ScopeInfo,
  [in]           LPDHCP_OPTION_DATA       OptionValue
);

參數

[in] ServerIpAddress

指定 DHCP 伺服器的 IP 位址或主機名的 Unicode 字串。

[in] Flags

指定位旗標，指出選項是否為廠商特定。 如果不是，這個參數應該是0。

值 意義
DHCP_FLAGS_OPTION_IS_VENDOR
 如果廠商提供選項，則應該設定此旗標。

[in] OptionId

DHCP_OPTION_ID值，其中包含所設定選項的唯一選項標識碼號碼 (也稱為「選項碼」) 。 定義其中許多選項識別碼;您可以在 找到 http://www.ietf.org/rfc/rfc2132.txt標準 DHCP 和 BOOTP 選項代碼的完整清單。

[in, optional] ClassName

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

[in, optional] VendorName

指定選項廠商的 Unicode 字串。 此參數是選擇性的，而且當 Flags 未設定為 DHCP_FLAGS_OPTION_IS_VENDOR 時，應該為 NULL。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO 結構的指標，其中包含描述 DHCP 範圍的資訊，將會設定這個選項值。

[in] OptionValue

DHCP_OPTION_DATA 結構的指標，其中包含對應至 OptionID 所指定 DHCP 選項程式代碼的數據值。

傳回值

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

規格需求

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

另請參閱

DHCP_OPTION_DATA

DHCP_OPTION_SCOPE_INFO

DhcpV4SetOptionValue