DhcpV4FailoverCreateRelationship 函式 (dhcpsapi.h)

  • 發行項

DhcpV4FailoverCreateRelationship函式會在兩部伺服器之間建立新的 DHCPv4 容錯移轉關聯性。

語法

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

參數

[in, optional] ServerIpAddress

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

[in] pRelationship

DHCP_FAILOVER_RELATIONSHIP結構的指標，其中包含要建立之 DHCPv4 容錯移轉關聯性的相關資訊。

傳回值

如果函式成功，它會傳回 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_EXISTS
 DHCPv4 伺服器上已經存在具有相同名稱的容錯移轉關聯性。
ERROR_DHCP_FO_RELATIONSHIP_NAME_TOO_LONG
 容錯移轉關聯性名稱的長度超過預期的長度。
ERROR_DHCP_FO_MAX_RELATIONSHIPS
 DHCP 伺服器上所設定的允許容錯移轉關聯性數目上限已超過。

需求

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

另請參閱

DhcpV4FailoverDeleteRelationship

DhcpV4FailoverEnumRelationship

DhcpV4FailoverGetRelationship

DhcpV4FailoverSetRelationship