dhcpGetAllOptionValues 函式 (dhcpsapi.h)

  • 發行項

DhcpGetAllOptionValues 函式會傳回數位列，其中包含針對 DHCP 伺服器上特定範圍定義的所有選項值。

語法

DWORD DhcpGetAllOptionValues(
  [in]  LPWSTR                   ServerIpAddress,
  [in]  DWORD                    Flags,
  [in]  LPDHCP_OPTION_SCOPE_INFO ScopeInfo,
  [out] LPDHCP_ALL_OPTION_VALUES *Values
);

參數

[in] ServerIpAddress

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

[in] Flags

指定位旗標，指出選項是否為廠商專屬。 如果不需要廠商選項的資格，此參數應該是 0。

值 意義
DHCP_FLAGS_OPTION_IS_VENDOR
 如果需要廠商特定的選項，應該設定此旗標。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO結構的指標，其中包含將傳回其選項值之特定範圍的資訊。 這項資訊會定義從預設、伺服器或範圍層級擷取的選項值，或針對特定 IPv4 保留專案擷取的選項值。

[out] Values

DHCP_ALL_OPTION_VALUES 結構的指標，其中包含 ScopeInfo 中所指定範圍的傳回選項值。

注意  

此參數的記憶體必須使用 DhcpRpcFreeMemory 釋放。

 

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_SUBNET_NOT_PRESENT
 這個指定的 IPv4 sunet 未定義在 DHCP 伺服器上。
ERROR_DHCP_NOT_RESERVED_CLIENT
 指定的 DHCP 用戶端不是保留的用戶端。

備註

DHCP 伺服器上定義之每個廠商/類別組的 Values 所指定的陣列中會有一個選項值。

規格需求

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

另請參閱

DhcpGetAllOptions