DhcpGetSubnetDelayOffer function (dhcpsapi.h)

The DhcpGetSubnetDelayOffer function obtains the delay period for DHCP OFFER messages after a DISCOVER message is received.

Syntax

DWORD DHCP_API_FUNCTION DhcpGetSubnetDelayOffer(
  [in]  LPWSTR          ServerIpAddress,
  [in]  DHCP_IP_ADDRESS SubnetAddress,
  [out] USHORT          *TimeDelayInMilliseconds
);

Parameters

[in] ServerIpAddress

Unicode string that specifies the IP address or hostname of the DHCP server.

[in] SubnetAddress

DHCP_IP_ADDRESS value that contains the IP address of the subnet gateway.

[out] TimeDelayInMilliseconds

Unsigned 16-bit integer value that receive the time to delay an OFFER message after receiving a DISCOVER message as configured on the DHCP server, in milliseconds.

Note  

The memory for this parameter must be free using DhcpRpcFreeMemory.

 

Return value

This function returns ERROR_SUCCESS upon a successful call. Otherwise, it returns one of the DHCP Server Management API Error Codes.

Return code Description
ERROR_ACCESS_DENIED
This call was performed by a client who is not a member of the "DHCP Administrators" security group.
ERROR_DHCP_SUBNET_NOT_PRESENT
The specified subnet is not defined on the DHCP server.
ERROR_INVALID_PARAMETER
One of the parameters provides an invalid value.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header dhcpsapi.h
Library Dhcpsapi.lib
DLL Dhcpsapi.dll

See also

DhcpSetSubnetDelayOffer