DhcpGetSuperScopeInfoV4 函式 (dhcpsapi.h)

  • 發行項

DhcpGetSuperScopeInfoV4 函式會傳回 DHCP 伺服器超範圍的相關信息。

語法

DWORD DhcpGetSuperScopeInfoV4(
  [in]  DHCP_CONST WCHAR         *ServerIpAddress,
  [out] LPDHCP_SUPER_SCOPE_TABLE *SuperScopeTable
);

參數

[in] ServerIpAddress

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

[out] SuperScopeTable

DHCP_SUPER_SCOPE_TABLE 結構，其中包含所提供 DHCP 伺服器超範圍傳回的資訊。

注意  

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

 

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。

備註

超級範圍是 DHCP 伺服器上定義的所有子網集合，因此所有範圍以及每個服務的 IP 位址範圍。 完全採用超範圍，可提供 DHCP 伺服器提供的所有 IP 位址的完整集合。 超級範圍數據表會提供與每個子網相關聯的IP位址。 若要取得每個所提供的IP範圍，應在數據表的每個DHCP_SUPER_SCOPE_TABLE_ENTRY結構中提供的IP位址上呼叫 DhcpGetSubnetInfo。

規格需求

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

另請參閱

DHCP_SUPER_SCOPE_TABLE

DhcpGetSubnetInfo

DhcpSetSuperScopeV4