Edit

Share via

IX509EnrollmentPolicyServer::GetNextUpdateTime method (certenroll.h)

  • Article

The GetNextUpdateTime method retrieves the date and time at which the policy expires and should be refreshed.

Syntax

HRESULT GetNextUpdateTime(
  [out, retval] DATE *pDate
);

Parameters

[out, retval] pDate

Pointer to a DATE value that identifies the time.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following table. For a list of common error codes, see Common HRESULT Values.

Return code Description
CERTSRV_E_PROPERTY_EMPTY
 The value could not be found.
E_POINTER
 The pDate parameter cannot be NULL.

Remarks

The date is stored as an 8-byte real value that represents a Coordinated Universal Time (Greenwich Mean Time) value between January 1, 1900 and December 31, 9999, inclusive. The value 2.0 represents January 1, 1900; 3.0 represents January 2, 1900. Adding 1 to the value increments the date by a day. The fractional part of the value represents the time of day. Therefore, 2.5 represents 12:00 on January 1, 1900; 3.25 represents 06:00 on January 2, 1900.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header certenroll.h

See also

IX509EnrollmentPolicyServer