dhcpGetOptionValueV6 函式 (dhcpsapi.h)

  • 發行項

DhcpGetOptionValueV6函式會針對特定使用者或廠商類別擷取 DHCPv6 伺服器上所定義之特定選項的選項值。

語法

DWORD DhcpGetOptionValueV6(
  [in]  LPWSTR                    ServerIpAddress,
  [in]  DWORD                     Flags,
  [in]  DHCP_OPTION_ID            OptionID,
  [in]  LPWSTR                    ClassName,
  [in]  LPWSTR                    VendorName,
  [in]  LPDHCP_OPTION_SCOPE_INFO6 ScopeInfo,
  [out] LPDHCP_OPTION_VALUE       *OptionValue
);

參數

[in] ServerIpAddress

指定 DHCPv6 伺服器的 IPv6 位址或主機名稱的 Unicode 字串。

[in] Flags

旗標值，指出選項適用于特定或預設廠商類別。

值 意義
0x00000000
 預設廠商類別會擷取選項值。
DHCP_FLAGS_OPTION_IS_VENDOR
0x00000003
 系統會針對特定廠商類別擷取選項值。 廠商名稱會以 VendorName提供。

[in] OptionID

DHCP_OPTION_ID 值，指定要擷取之選項的選項識別碼。

[in] ClassName

Null 終止 Unicode 字串的指標，其中包含要求選項值的使用者類別名稱。 這是選擇性參數。

[in] VendorName

Null 終止的 Unicode 字串指標，其中包含要求選項值之廠商類別的名稱。 此參數是選擇性的;如果未指定任何值，則會假設預設廠商類別。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO6結構的指標，其中包含要求選項為值之 DHCPv6 範圍的相關資訊。 具體來說，它會定義是否要針對預設、伺服器或範圍層級或特定 IPv6 保留擷取選項。

[out] OptionValue

作業所傳回 之DHCP_OPTION_VALUE 結構的位址指標，其中包含對應至 OptionID的選項值。

傳回值

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

傳回碼 描述
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全性群組成員的用戶端所執行。
ERROR_FILE_NOT_FOUND
 系統找不到指定的檔案。
ERROR_DHCP_SUBNET_NOT_PRESENT
 在 DHCPv6 伺服器上未定義指定的子網。
ERROR_DHCP_OPTION_NOT_PRESENT
 指定的選項未在 DHCPv6 伺服器上的指定層級定義。
ERROR_DHCP_NOT_RESERVED_CLIENT
 DHCPv6 伺服器上未定義保留的 IPv6 用戶端。

備註

此函式的呼叫端必須釋放 OptionValue所指向的記憶體。

需求

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

另請參閱

DHCP_OPTION_SCOPE_INFO6