3.2.4.100 R_DhcpV4FailoverGetSystemTime (Opnum 99)

The R_DhcpV4FailoverGetSystemTime method is used to return the current time on the DHCP server.

 DWORD R_DhcpV4FailoverGetSystemTime(
   [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress,
   [out] LPDWORD pTime
 );

ServerIpAddress: The IP address/host name of the DHCP server. This parameter is unused.

pTime: This is a pointer to type DWORD and returns the current time, in seconds elapsed since midnight, January 1, 1970, Coordinated Universal Time (UTC), on the DHCP server. The caller of the API must allocate the memory for this parameter.

Return Values: A 32-bit unsigned integer value that indicates return status. A return value ERROR_SUCCESS (0x00000000) indicates that the operation was completed successfully. Otherwise, it contains a Win32 error code, as specified in [MS-ERREF]. This error code value can correspond to a DHCP-specific failure, which takes a value between 20000 and 20123, or any generic failure.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The call was successful.

The opnum field value for this method is 99.

When processing this call, the DHCP server MUST do the following:

  • Return ERROR_INVALID_PARAMETER if the pTime parameter is NULL.

  • Return current DHCP server time, in seconds elapsed since midnight, January 1, 1970, UTC, in the pTime parameter.

  • Return ERROR_SUCCESS.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol specified in [MS-RPCE].