DhcpV4FailoverAddScopeToRelationship 函式 (dhcpsapi.h)

  • 發行項

DhcpV4FailoverAddScopeToRelationship 函式會將 DHCPv4 範圍新增至指定的故障轉移關聯性。

語法

DWORD DHCP_API_FUNCTION DhcpV4FailoverAddScopeToRelationship(
  [in, optional] LPWSTR                       ServerIpAddress,
  [in]           LPDHCP_FAILOVER_RELATIONSHIP pRelationship
);

參數

[in, optional] ServerIpAddress

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

[in] pRelationship

DHCP_FAILOVER_RELATIONSHIP結構的指標，其中包含要加入的範圍資訊，以及要修改的故障轉移關聯性。

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_DHCP_SUBNET_NOT_PRESENT
 DHCPv4 伺服器上不存在IPv4範圍。
ERROR_DHCP_FO_SCOPE_ALREADY_IN_RELATIONSHIP
 IPv4 範圍已經是另一個故障轉移關聯性的一部分。
ERROR_DHCP_FO_RELATIONSHIP_DOES_NOT_EXIST
 故障轉移關聯性不存在。
ERROR_DHCP_FO_MAX_ADD_SCOPES
 要新增至故障轉移關聯性的範圍數目超過一次可新增至故障轉移關聯性的最大範圍數目。

規格需求

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

另請參閱

DhcpV4FailoverDeleteScopeFromRelationship

DhcpV4FailoverGetScopeRelationship

DhcpV4FailoverGetScopeStatistics