DhcpV4FailoverGetScopeRelationship 函式 (dhcpsapi.h)

  • 發行項

DhcpV4FailoverGetScopeRelationship函式會擷取在指定 DHCPv4 範圍上設定的容錯移轉關聯性。

語法

DWORD DHCP_API_FUNCTION DhcpV4FailoverGetScopeRelationship(
  [in, optional] LPWSTR                       ServerIpAddress,
  [in]           DHCP_IP_ADDRESS              ScopeId,
  [out]          LPDHCP_FAILOVER_RELATIONSHIP *pRelationship
);

參數

[in, optional] ServerIpAddress

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

[in] ScopeId

包含要擷取關聯性詳細資料的 IPv4 範圍位址 的DHCP_IP_ADDRESS 欄位。

[out] pRelationship

DHCP_FAILOVER_RELATIONSHIP結構的指標，其中包含其pScopes成員中包含scopeId欄位之擷取容錯移轉關聯性的相關資訊。

注意  

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

 

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_DHCP_FO_SCOPE_NOT_IN_RELATIONSHIP
 IPv4 子網不是容錯移轉關聯性的一部分。

需求

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

另請參閱

DhcpV4FailoverAddScopeToRelationship

DhcpV4FailoverDeleteScopeFromRelationship

DhcpV4FailoverGetScopeStatistics