DhcpV4FailoverGetRelationship 函式 (dhcpsapi.h)

  • 發行項

DhcpV4FailoverGetRelationship函式會擷取特定關聯性名稱的關聯性詳細資料。

語法

DWORD DHCP_API_FUNCTION DhcpV4FailoverGetRelationship(
  [in, optional] LPWSTR                       ServerIpAddress,
  [in]           LPWSTR                       pRelationshipName,
  [out]          LPDHCP_FAILOVER_RELATIONSHIP *pRelationship
);

參數

[in, optional] ServerIpAddress

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

[in] pRelationshipName

Null 終止 Unicode 字串的指標，表示要擷取之關聯性的名稱。

[out] pRelationship

包含所擷取容錯移轉關聯性相關資訊 之DHCP_FAILOVER_RELATIONSHIP 結構的指標。

注意  

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

 

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_DHCP_FO_RELATIONSHIP_DOES_NOT_EXIST
 容錯移轉關聯性不存在。

需求

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

另請參閱

DhcpV4FailoverCreateRelationship

DhcpV4FailoverDeleteRelationship

DhcpV4FailoverEnumRelationship

DhcpV4FailoverSetRelationship