DhcpV4FailoverTriggerAddrAllocation function (dhcpsapi.h)
The DhcpV4FailoverTriggerAddrAllocation function redistributes the free addresses between the primary server and the secondary server that are part of a failover relationship.
DWORD DHCP_API_FUNCTION DhcpV4FailoverTriggerAddrAllocation( [in, optional] LPWSTR ServerIpAddress, [in] LPWSTR pFailRelName );
[in, optional] ServerIpAddress
Pointer to a null-terminated Unicode string that represents the IP address or hostname of the DHCP server.
Pointer to a null-terminated Unicode string that represents the name of the failover relationship for which free addresses are to be redistributed.
If the function succeeds, it returns ERROR_SUCCESS.
If the function fails, it returns one of the following or an error code from DHCP Server Management API Error Codes.
||One or more of the parameters were invalid.|
||Failover relationship doesn't exit.|
||The serverType member of failover relationship is SecondaryServer.|
|Minimum supported client||None supported|
|Minimum supported server||Windows Server 2012 [desktop apps only]|