DhcpSetSuperScopeV4 函式 (dhcpsapi.h)

  • 發行項

DhcpSetSuperScopeV4 函式會將子網設定為 DHCP 伺服器上的超級範圍。

語法

DWORD DhcpSetSuperScopeV4(
  [in]           DHCP_CONST WCHAR           *ServerIpAddress,
  [in]           DHCP_CONST DHCP_IP_ADDRESS SubnetAddress,
  [in, optional] DHCP_CONST LPWSTR          SuperScopeName,
  [in]           DHCP_CONST BOOL            ChangeExisting
);

參數

[in] ServerIpAddress

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

[in] SubnetAddress

DHCP_IP_ADDRESS 值，其中包含將定義為超級範圍的子網IP位址。

[in, optional] SuperScopeName

指定超級範圍新名稱的 Unicode 字串指標。

[in] ChangeExisting

指定是否要將現有的超級範圍變更為提供的子網。 如果此參數為 TRUE ，且另一個子網設定為超級範圍，請將超級範圍變更為提供的子網;否則，如果設定為 FALSE 且另一個子網定義為超級範圍，請勿變更它。

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器的資料庫時發生錯誤。
ERROR_INVALID_PARAMETER
 其中一個參數提供無效的值。

備註

超級範圍是一個子網，其中包含可供租用之所有位址的完整範圍 (，或已在 DHCP 伺服器上定義的子網範圍內) 租用。

規格需求

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

另請參閱

DhcpDeleteSuperScopeV4