DhcpSetOptionInfoV5 函式 (dhcpsapi.h)

  • 發行項

DhcpSetOptionInfoV5 函式會設定特定 DHCP 選項的資訊。

語法

DWORD DhcpSetOptionInfoV5(
  [in] LPWSTR         ServerIpAddress,
  [in] DWORD          Flags,
  [in] DHCP_OPTION_ID OptionID,
  [in] LPWSTR         ClassName,
  [in] LPWSTR         VendorName,
  [in] LPDHCP_OPTION  OptionInfo
);

參數

[in] ServerIpAddress

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

[in] Flags

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

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

[in] OptionID

DHCP_OPTION_ID 值，指定特定 DHCP 選項的程式代碼。

[in] ClassName

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

[in] VendorName

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

[in] OptionInfo

DHCP_OPTION 結構的指標，其中包含 OptionID 所指定選項的相關信息。

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCPv6 伺服器的資料庫時發生錯誤。
ERROR_DHCP_CLASS_NOT_FOUND
 提供的類別名稱不正確或不存在於 DHCP 伺服器上。

規格需求

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

另請參閱

DHCP_OPTION

DhcpGetOptionInfoV5