CSSM_GetTimeValue, CSP_GetTimeValue — Get a CSP time value (CDSA)
# include <cssm.h>
CSSM_RETURN CSSMAPI CSSM_GetTimeValue
CSSM_RETURN CSSMCSPI CSP_GetTimeValue
Common Security Services Manager library (cdsa$incssm300_shr.exe)
| || |
Handle of the Cryptographic Service Provider that
will perform the operation.
| || |
A CSSM algorithm type that indicates the method
for fetching the time. The following algorithm types are supported:
CSSM_ALGID_UTC Returns a time value in the form YYYYMMDDhhmmss
(4 characters for the year; 2 characters each for the month, the
day, the hour, the minute, and the second). The time returned is
CSSM_ALGID_RUNNING_COUNTER The current value of a running
hardware counter that operates while the device is in operation.
This value can be read from a processor counter provided by some
| || |
The time value of counter value returned in response
to the request.
This function returns a time value maintained by a CSP. This
feature will be supported primarily by hardware tokens with an onboard
real time clock.
The output is returned to the caller either by filling the
caller-specified buffer or by using the application's declared memory
allocation functions to allocate buffer space. To specify a specific,
preallocated output buffer, the caller must provide an array of
one or more CSSM_DATA structures, each containing a Length field
value greater than zero and a non-NULL data pointer field value.
To specify automatic output buffer allocation by the CSP, the caller
must provide an array of one or more CSSM_DATA structures, each
containing a Length field value equal to zero and a NULL data pointer
field value. The application is always responsible for deallocating
the memory when it is no longer needed.
Some tokens require authentication before returning a time
A CSSM_RETURN value indicating success or specifying a particular
error condition. The value CSSM_OK indicates success. All other
values represent an error condition.
Errors are described in the CDSA Technical Standard.
None specific to this call.
Intel CDSA Application Developer's Guide