DhcpSetOptionValueV6 函式 (dhcpsapi.h)

  • 發行項

DhcpSetOptionValueV6函式會設定 DHCP 伺服器上特定選項值的資訊。

語法

DWORD DHCP_API_FUNCTION DhcpSetOptionValueV6(
  [in] LPWSTR                    ServerIpAddress,
  [in] DWORD                     Flags,
  [in] DHCP_OPTION_ID            OptionId,
  [in] LPWSTR                    ClassName,
  [in] LPWSTR                    VendorName,
  [in] LPDHCP_OPTION_SCOPE_INFO6 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] ClassName

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

[in] VendorName

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

[in] ScopeInfo

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

[in] OptionValue

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

傳回值

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

傳回碼 描述
ERROR_INVALID_PARAMETER
 參數無效。
ERROR_DHCP_OPTION_NOT_PRESENT
 DHCP 伺服器上沒有指定的選項。

需求

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