DhcpV4FailoverGetAddressStatus 函式 (dhcpsapi.h)

DhcpV4FailoverGetAddressStatus 函式會傳回 IPv4 位址的狀態。

語法

DWORD DHCP_API_FUNCTION DhcpV4FailoverGetAddressStatus(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in, out]      LPDWORD         pStatus
);

參數

[in, optional] ServerIpAddress

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

[in] SubnetAddress

DHCP_IP_ADDRESS 結構，其中包含要求其狀態的 IPv4 位址。

[in, out] pStatus

DWORD 的指標，會傳回下表所指定 IPv4 位址的狀態：

值	意義
0	主伺服器將會租用IPv4位址。
1	輔助伺服器將會租用IPv4位址。
2	IPv4 位址是排除範圍的一部分。
3	IPv4 位址是保留。

傳回值

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

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

規格需求

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