dhcpV4GetAllOptionValues 函式 (dhcpsapi.h)

  • 發行項

DhcpV4GetAllOptionValues函式會擷取 DHCP 選項值的陣列， (特定範圍的選項碼和相關聯的資料) 。

語法

DWORD DHCP_API_FUNCTION DhcpV4GetAllOptionValues(
  [in, optional] LPWSTR                      ServerIpAddress,
  [in]           DWORD                       Flags,
  [in]           LPDHCP_OPTION_SCOPE_INFO    ScopeInfo,
  [out]          LPDHCP_ALL_OPTION_VALUES_PB *Values
);

參數

[in, optional] ServerIpAddress

Null 終止的 Unicode 字串指標，表示 DHCP 伺服器的 IP 位址或主機名稱。

[in] Flags

指出選項值適用于特定或預設廠商。

Flags 意義
0x00000000
 預設廠商會擷取選項值。
DHCP_FLAGS_OPTION_IS_VENDOR
0x00000003
 系統會針對特定廠商擷取選項值。

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO結構的指標，其中包含要擷取之選項值範圍的相關資訊。

[out] Values

DHCP_ALL_OPTION_VALUES_PB結構的指標，其中包含ScopeInfo中所指定範圍的擷取選項值。

DHCP 伺服器上定義之每個廠商/原則組的陣列中有一個選項值。

傳回值

如果函式成功，則會傳回 ERROR_SUCCESS。

如果函式失敗，它會從 DHCP 伺服器管理 API 錯誤碼傳回下列其中一個錯誤碼或錯誤碼。

值 意義
ERROR_INVALID_PARAMETER
 一或多個參數無效。

備註

值 應該使用 DhcpRpcFreeMemory免費。

需求

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

另請參閱

DhcpV4GetOptionValue

DhcpV4RemoveOptionValue

DhcpV4SetOptionValue

DhcpV4SetOptionValues